增强 现实 (Augmented Reality) 简称 AR， 是 一 种 实时 计算 摄像 机 捕捉 到 的 现实 影像 的 位 置 及 角度 并 加 上 相应 虚拟 信息 的 技术 。 这 种 技术 不 仅 能 展现 真实 世界 的 信息 ， 还 能 通过 增加 虚拟 信息 而 对 现实 世 
界 进行 增强 ， 所 以 称 为 增强 现实 。AR 可 应 用 于 军事 、 医 疗 、 工 业 、 教 育 等 众多 领域 ， 随 着 硬件 性 能 的 提升 和 软件 解决 方案 的 日 趋 成 熟 ，AR 产 品 将 越 来 越 多 地 走 入 人 们 的 视线 。 


EMIR (Virtual Reality) 简称 VR， 它 通过 计算 机 图 形 系统 以 及 多 种 传感器 控制 设备 将 人 带 入 虚拟 世界 中 ， 并 与 虚拟 世界 产生 各 种 交互 ， 具 有 强烈 的 沉浸 式 体 验 。VR 将 在 游戏 、 影 视 、 城 市 规划 、 室 内 


设计 、 地 产 、 教 育 等 多 个 领域 为 人 们 提供 更 加 真实 、 震 扼 的 全 新 体验 。 
随 着 AR 和 VR 技术 的 飞速 发 展 ， 由 此 产生 的 众多 应 用 场景 将 需要 大 量 技术 人 才 ， 尤 其 是 程序 设计 人 才 。 本 书 的 目的 是 为 程序 开发 者 提供 全 面 、 权 威 的 参考 资料 ， 并 附 有 大 量 真实 案例 ， 详 细 讲 解 AR、VR 


开发 的 流程 和 步骤 。 

本 书 分 为 两 大 部 分 ， 第 一 部 分 是 “AR 开发 ”， 共 12 章 : 

- 第 1 章 简要 介绍 AR 技术 的 概念 和 常用 的 AR 解决 方案 。 

` 第 2 章 主要 介绍 基于 Vuforia SDK 的 应 用 开发 。 

- 第 3~9 章 主要 介绍 AR 项 目 中 常见 的 案例 以 及 实现 方法 ， 例 如 透明 视频 、AR 对 战 游 戏 、 涂 色 类 产品 等 。 

- 第 10 章 重点 讲解 国内 AR 解决 方案 HiAR SDK 的 开发 。 

` 第 11 章 简要 介绍 其 他 AR SDK 的 使 用 。 

- 第 12 章 简要 介绍 AR 创建 工具 “ 找 趣 ” 的 使 用 。 

第 二 部 分 是 “VR 开 发 ”， 共 6 章 : 

` 第 13 章 简要 介绍 VR 技术 的 概念 和 主流 的 VR 设备 。 

- 第 14 章 主要 介绍 基于 Google Cardboard 开 发 VR 应 用 。 

- 第 15 章 主要 介绍 HTC Vive 的 常用 功能 及 其 实现 。 

` 第 16、17 章 通过 案例 方式 讲解 基于 HTC Vive 的 项 目 开发 。 

: 第 18 章 简要 介绍 目前 市 场 上 的 其 他 VR 设备 及 相关 技术 。 

本 书 专注 于 AR 和 VR 开发 ， 因 此 不 过 多 涉及 编程 语言 的 基础 知识 及 引擎 的 使 用 方法 ， 阅 读本 书 需要 先 掌 握 C# 编 程 技 术 ， 并 能 够 熟练 使 用 Unity 3D 引 掌 。 如 果 你 没有 C# 和 Unity 的 使 用 经 验 ， 那 么 在 阅读 本 
书 之 前 需要 先 学 习 相 关 技术 。 

在 编写 本 书 的 过 程 中 ， 我 们 得 到 了 亮 风 台 科 技 、 克 科技 、RealMax 等 企业 的 技术 支持 和 宝贵 意见 ， 在 此 表示 衷心 的 感谢 。 感 谢 ARinChina CEO 张 明 军 提供 的 优质 平台 与 宝贵 资源 ， 感 谢 ARinChina 同 事 董 艳 
超 、 张 荣 为 本 书 的 出 版 辛苦 奔波 ， 感 谢 ARinChina 站 长 赵亮 、ARinChina 技 术 论 坛 版 主 赵 患 立 提 供 高 质量 的 技术 支持 ， 感 谢 付 旭 所 提供 美术 支持 。 最 后 ， 特 别 感 谢 ARinChina 工 程 师 赵 兴 、 谢 有 龙 、 陈 家 之 、 常 
壮 等 同事 ， 他 们 在 本 书 编著 过 程 中 付出 了 无 数 汗水 。 

本 书 是 非常 好 的 AR 和 VR 入 门 教程 ， 适 用 于 高 校 计算 机 相关 专业 学 生 学 习 AR 和 VR 技术 ， 同 时 由 于 书 中 附 有 大 量 案 例 ， 所 以 同样 适用 于 企业 开发 人 员 。 如 果 你 在 项 目 中 遇 到 相似 的 需求 ， 或 许 也 可 以 从 本 
书 中 获取 一 些 灵感 和 帮助 。 

如 果 本 书 能 为 你 的 学 习 或 工作 带 来 帮助 和 提升 ， 将 是 我 们 莫大 的 荣幸 。 真 诚 希 望 本 书 的 读者 给 我 们 更 多 的 反馈 和 意见 ， 和 帮助 我 们 取得 更 大 的 进步 和 成 长 。 在 阅读 本 书 的 过 程 中 若 有 疑问 ， 欢 迎 加 入 本 书 
QQ 群 进行 交流 ， 我 们 会 在 群 里 提供 本 书 的 所 有 资源 和 相关 工具 ，QQ 群 号 为 588206982。 
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第 一 部 分 АКА 


. 第 1 章 AR 技术 简介 

. 第 2 章 ”基于 Vuforia SDK 开 发 AR 应 用 

` 第 3 章 ”AR 内容 交 互 

` 第 4 章 AR 互动 大 屏 : 透明 视频 的 实现 
: 第 5 章 AR 动画 : AR 与 Flash 动 画 的 结合 
Жб ”AR 游戏 开发 : 卡 牌 对 战 

` 第 7 章 涂 色 类 AR 开发 

| 第 8 章 ”使 用 陀螺 仪 模拟 SLAM 功 能 

: 第 9 章 ”Unity 与 原生 代码 之 间 的 交互 

. 第 10 章 使 用 HiAR SDK 开 发 AR 应 用 

. 第 11 章 ”其 他 AR SDK Ê A 


: 第 12 章 АКЕ тА: KAR (realcast) 浏览 器 


第 1 章 AR 技术 简介 


增强 现实 (Augmented Reality, AR) 是 一 种 实时 计算 摄影 机 影像 的 位 置 及 角度 并 加 上 相应 图 像 的 技术 ， 这 种 技术 的 目标 是 在 屏幕 上 把 虚拟 世界 套 在 现实 世界 中 并 进行 互动 。 这 种 技术 于 20 世 纪 90 年 代 
提出 ， 随 着 随身 电子 产品 运算 能 力 的 提升 ， 其 用 途 将 会 越 来 越 广 。 


目前 对 于 增强 现实 有 两 种 通用 的 定义 。 一 种 定义 是 北 卡 大 学 罗 纳 德 . 阿 祖玛 (Ronald Azuma) 于 1997 年 提出 的 ， 他 认为 增强 现实 包括 三 个 方面 的 内 容 : 将 虚拟 物 与 现实 结合 、 即 时 互动 、 三 维 。 另 一 种 
定义 是 保罗 :米尔 格拉 姆 (Paul Milgram) 和 岸 野 文 即 (Fumio Kishino) 于 1994 年 提出 的 现实 -虚拟 连续 统 (Milgram' s Reality-Virtuality Continuum) 。 后 者 将 真实 环境 和 虚拟 环境 分 别 作为 连续 统 的 
两 端 ， 它 们 的 中 间 地 带 称 为 “混合 现实 ” (Mixed Reality) ， 其 中 靠近 真实 环境 的 是 增强 现实 (Augmented Reality) ， 靠 近 虚 拟 环境 的 则 是 虚拟 现实 (Virtual Reality) 。 


增强 现实 技术 在 工业 上 的 应 用 已 有 不 少 ， 目 前 主要 用 于 大 型 机 械 的 维修 和 制造 。 另 外 ， 增 强 现实 技术 在 教育 、 医 疗 、 房 产 、 游 戏 等 多 个 领域 的 应 用 同样 很 多 。 


总 的 来 讲 ， 增 强 现 实 技术 现在 还 处 于 起 步 阶 段 ， 大 多 数 AR 应 用 都 运行 在 智能 手机 上 ， 通 过 图 像 识 别 等 技术 实现 简单 的 增强 现实 效果 。 其 采用 的 解决 方案 大 部 分 是 利用 Unity 3D 等 游戏 引 警 配 合 AR SDK 
进行 开发 ， 目 前 最 受 欢迎 的 SDK 有 国外 的 Vuforia SDK 以 及 国内 的 HiAR SDK, 


Vuforia SDK 最 早 是 高 通 (Qualcomm) 公司 的 AR 解 决 方案 ， 后 被 PTC 收 购 ， 目 前 仍 致 力 于 AR 以 及 MR 技术 的 研究 。Vuforia 集 成 了 图 像 识 别 和 物体 识别 ， 支 持 与 三 星 Gear VR 或 微软 Hololens 相 结合 能 
应 用 开发 。 


HiAR 是 亮 风 台 研 发 的 AR 基 础 开发 平台 ， 提 供 HiAR SDK、HIiAR 云 、 管 理 后 台 和 浏览 器 幻 镜 等 一 系列 完整 的 AR 开 发 支持 ， 专 注 于 为 开发 者 带 来 最 好 的 AR 服 务 。HiAR SDK 功 能 全 面 ， 支 持平 面 识 别 、3D 
识别 、 空 间 建 模 、 人 脸 增强 和 姿态 跟踪 。2016 年 里 约 奥运 会 ， 在 HiAR SDK 的 支持 下 ， 腾 讯 手机 QQ 于 世界 范围 内 展开 AR 火 炬 传递 活动 ， 创 造 了 AR 互 动 破 亿 次 的 吉 尼 斯 世界 纪录 。 HIiAR 云 平台 是 国内 首 款 
AR 云 ,支持 亿 级 图 库 秒 级 搜索 ， 识 别 准确 率 高 达 96%， 是 国内 AR 平 台中 准确 率 最 高 、 响 应 速度 最 快 、 识 别 图 库 最 大 的 AR 云 。 迄 今 为 止 ，HiAR 已 成 为 全 球 用 户 量 最 多 的 AR 开 发 平台 之 一 ， 覆 盖 用 户 超 过 8 
亿 ， 三星 、 腾 讯 、 百 度 、 华 为 、OPPO、 大 强 、 搜 狐 等 企业 均 在 HiAR 获 取 AR 技 术 支 持 与 服务 。 


本 书 将 介绍 图 形 图 像 识 别 、 简 单 的 几何 体 识 别 、3D 物 体 识 别 等 目前 常用 的 AR 开 发 技术 ， 并 结合 Vuforia、HiAR、Wikitude、VoidAR 等 知名 AR 开 发 工具 包 (SDK) ， 以 案例 形式 讲解 AR 在 各 个 领域 中 
的 应 用 方案 。 


由 于 本 书 将 重点 讲解 AR 技 术 开 发 ， 因 此 假设 读者 已 经 掌握 了 C# 编 程 语言 以 及 Unity 3D 开 发 ， 如 果 读 者 对 此 没有 接触 ， 建 议 首先 学 习 C# 以 及 Unity Зр. 


第 2 章 ”基于 Vuforia SDK 开 发 AR 应 用 


2.1 准备 Vuforia 开 发 环境 


1.Vuforia 简 介 


Vuforia 是 一 款 能 为 现实 世界 物体 带 来 互动 体验 的 AR 开发 平台 ， 虽 在 帮助 开发 者 打造 全 新 级 别 的 真实 世界 物品 与 虚拟 物品 的 互动 。 它 使 用 计算 机 视觉 技术 来 实时 地 识别 和 跟踪 平面 图 像 以 及 简单 的 3D 物 
体 ， 使 开发 者 能 够 在 现实 世界 和 数字 体验 之 间架 起 桥梁 。 


Vuforia 通 过 Unity 游 戏 引擎 扩展 提供 了 C、Java、Objective-C 和 .NET 语 言 的 应 用 程序 编程 接口 ， 能 够 同时 支持 iDOS 和 Android 的 原生 开发 ， 使 得 开发 者 在 Untiy 引 警 中 开发 的 AR 应 用 很 容易 移植 到 jiOS 和 
Android 平 台 上 。 


2. 注 册 成 为 Vuforia 用 户 
(1) 打开 Vuforia 官 网 https://developer.vuforia.com/。 


(2) 如 果 你 已 经 是 Vuforia 注 册 用 户 ， 就 可 以 直接 输入 邮箱 和 密码 登录 Vuforia 管 理 后 台 ; 如 果 你 还 没有 注册 过 Vuforia 用 户 ， 则 需要 点 击 注册 并 填写 相关 注册 信息 。 


(3) 在 完成 注册 信息 填写 后 ，Vuforia 会 给 注册 邮箱 发 送 一 封 激活 邮件 ， 登 录 邮 箱 按照 提示 操作 即 可 激活 Vuforia 账 户 。 


(4) 在 激活 Vuforia 账 户 后 就 可 以 点 击 登录 进入 Vuforia 管 理 后 台 了 ， 如 下 图 所 示 。 


Vuforia" Developer Portal Login | Register 


Home Pricing Downloads Library Develop Support 


3. 下 载 Vuforia SDK for Unity 


(1) 点 击 上 图 中 的 Downloads 链 接 并 按照 下 图 所 示 完 成 操作 ， 注 意 在 下 载 列 表 中 选择 Download for Unity, 


Vuforia" Developer Portal 


Home Pricing Downloads Library Develop Support 


Samples ^ Tools 


Vuforia 5.5 SDK 


Use the Vuforia SDK to build Android and iOS applications for mobile 
devices and digital eyewear. Apps can be built with Android Studio 
(JavaljL++) XCode (C++), and Unity, the cross-platform game engine. 

[I Download for Android 

vuforia-sdk-android-5-5-9.zip (6.99 MB) 

Download for iOS 

vuforia-sdk-ios-5-5-9.zip (17.10 MB) 
` Download for Unity 

vuforia-unity-5-5-9.unitypackaqe (34.50 MB) 


Release Notes 


(2) 本 节 下 载 的 Vuforia SDK 版 本 为 vuforia-unity-5-0-5。 下 载 解压 完成 后 会 得 到 后 缀 名 为 .unitypackage 的 Unity 插 件 包 。 
4.Vuforia 5.0.5 SDK 支 持 的 环境 

(1) Android 平 台 支 持 的 最 低 版 本 是 Android 4.0.3, 

(2) Unity 支 持 版 本 为 4.6.7 一 5.1.3p1 (本 节 使 用 的 Unity 版 本 为 5.0.2f1) 。 
5. 新 建 Unity 工 程 


运行 Unity 程 序 ， 按 照 步骤 创建 一 个 新 的 Unity 工 程 ， 也 可 以 直接 打开 已 有 的 Unity 工 程 来 进行 Vuforia SDK 导 入 。 


Projects Get started 


New Unity Project 


Location* 


3D 2D аск Create project 


Asset packages... 


=} Community Documentation Tutonals 


- VutoriaDemo - PC, | 


File Edit Assets GameObject Component Window Help 
eA Pivot Local | | Layers -| [Layout 


Tz Hierarchy „= | # Scene € Game -= Ө Inspector 
Create - | Shaded , 2D : | 

Main Camera 

Directional Licht 


® Project 
Create + 
Ё Favorites Assets 
Q All Materials 
Q AI Models 
Q AI Prefabs 
Q All Scripts 


Em Assets 


6.E A Vuforia SDK for Unity 插 件 


双击 在 步骤 3 中 下 载 的 .unitypackage 插 件 包 ， 弹 出 以 下 窗口 后 点 击 Import。 


] vuforia-unity-5-0-5 


4_ Editor 
B PostProcessBuildPlayer 
= license 3rdpartynotice.txt 
lË link .x ml 
v B3 Plugins 
"Em Android 
B androidManifest.xml 
£ libs 
ГЕВ armeabi-v7a 
B libocaRunityPlayer.so 
B libocARWrapper.so 
В libVuforia,so 
B ocaRunityPlayer.jar 
r src 
"B com 


v ш qualcomm 


e HE z. = A гата. РЇ 


Al ' | None | 


7 
7 
7 
7 
7 
| 属 
| 
7 
7 
M 
7 
7 
7 
7 
7 
V 


"n 


也 可 以 在 菜单 栏 中 选择 Assets 一 Import Package— Custom Package， 然 后 再 选择 .unitypackage 文 件 来 导入 插件 。 


如 果 出 现 以 下 界面 ， 点 击 “I Made a Backup.Go Ahead! ”按钮 即 可 。 


E 
| 
| 


This project contains scripts and/or assemblies that use 
obsolete APIs. 


If you choose Go Ahead', Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 


before proceeding. 


(You can always run the API Updater manually via the 
Assets/Run API Updater menu command.) 


在 导入 完成 后 ，Project 窗 口中 显示 如 下 : 


Project 
Create + 


Yr Favorites Assets » 
q all Materials 


СДАН Models 
Q All Prefabs — — — ss енн 


а All Scripts Фив ev 


qui toten, 


= Assets Editor Plugins Streaming... Vuforia license 3r.. 
Bm Editor 
бш Plugins 
Bs StreamingAssets 
8s Vuforia 


至 此 ，Vuforia SDK 已 经 成 功 导入 了 新 建 的 Unity 项 目 中 ， 接 下 来 可 以 创建 开发 Demo。 


第 2 章 ”基于 Vuforia SDK 开 发 AR 应 用 


2.1 准备 Vuforia 开 发 环境 
1.Vuforia 简 介 


Vuforia 是 一 款 能 为 现实 世界 物体 带 来 互动 体验 的 AR 开发 平台 ， 虽 在 帮助 开发 者 打造 全 新 级 别 的 真实 世界 物品 与 虚拟 物品 的 互动 。 它 使 用 计算 机 视觉 技术 来 实时 地 识别 和 跟踪 平面 图 像 以 及 简单 的 3D 物 
体 ， 使 开发 者 能 够 在 现实 世界 和 数字 体验 之 间架 起 桥梁 。 


Vuforia 通 过 Unity 游 戏 引擎 扩展 提供 了 C、Java、Objective-C 和 .NET 语 言 的 应 用 程序 编程 接口 ， 能 够 同时 支持 iDOS 和 Android 的 原生 开发 ， 使 得 开发 者 在 Untiy 引 警 中 开发 的 AR 应 用 很 容易 移植 到 jiOS 和 
Android 平 台 上 。 


2. 注 册 成 为 Vuforia 用 户 
(1) 打开 Vuforia 官 网 https://developer.vuforia.com/。 
(2) 如 果 你 已 经 是 Vuforia 注 册 用 户 ， 就 可 以 直接 输入 邮箱 和 密码 登录 Vuforia 管 理 后 人 台 ;， 如 果 你 还 没有 注册 过 Vuforia 用 户 ， 则 需要 点 击 注册 并 填写 相关 注册 信息 。 
(3) 在 完成 注册 信息 填写 后 ，Vuforia 会 给 注册 邮箱 发 送 一 封 激活 邮件 ， 登 录 邮箱 按照 提示 操作 即 可 激活 Vuforia 账 户 。 


(4) 在 激活 Vuforia 账 户 后 就 可 以 点 击 登录 进入 Vuforia 管 理 后 台 了 ， 如 下 图 所 示 。 


Vuforia" Developer Portal 


Log In | Register 


Home Pricing Downloads Library Develop Support 


3. F#kVuforia SDK for Unity 


(1) 点 击 上 图 中 的 Downloads 链 接 并 按照 下 图 所 示 完 成 操作 ， 注 意 在 下 载 列 表 中 选择 Download for Unity, 


Vuforia" Developer Portal 


Home Pricing Downloads Library Develop 


Samples ^ Tools 


Vuforia 5.5 SDK 


Support 


Use the Vuforia SDK to build Android and iOS applications for mobile 


devices and digital eyewear. Apps can be built with Android Studio 
(Јама/С++), XCode (C++), and Unity, the cross-platform game engine. 


Download for Android 
vuforia-sdk-android-5-5-9.zip (6.99 MB) 


Download for iOS 
vuforia-sdk-ios-5-5-9.2zip (17.10 MB) 


Download for Unity 
vuforia-unity-5-5-OS.unitypackage (34.50 MB) 


Release Notes 


(2) 本 节 下 载 的 Vuforia SDK 版 本 为 vuforia-unity-5-0-5。 下 载 解压 完成 后 会 得 到 后 缀 名 为 .unitypackage 的 Unity 插 件 包 。 
4.Vuforia 5.0.5 SDK 支 持 的 环境 

(1) Android 平 台 支 持 的 最 低 版 本 是 Android 4.0.3. 

(2) Unity 支 持 版 本 为 4.6.7 一 5.1.3p1 (本 节 使 用 的 Unity 版 本 为 5.0.2f1) 。 
5. 新 建 Unity 工 程 


运行 Unity 程 序 ， 按 照 步 又 创建 一 个 新 的 Unity 工 程 ， 也 可 以 直接 打开 已 有 的 Unity 工 程 来 进行 Vuforia SDK 导 入 。 


Projects Get started 


New Unity Project 
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3D 2D аск Create project 
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6.E A Vuforia SDK for Unity 插 件 


双击 在 步骤 3 中 下 载 的 .unitypackage 插 件 包 ， 弹 出 以 下 窗口 后 点 击 Import。 
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也 可 以 在 菜单 栏 中 选择 Assets 一 Import Package— Custom Package， 然 后 再 选择 .unitypackage 文 件 来 导入 插件 。 


如 果 出 现 以 下 界面 ， 点 击 “I Made a Backup.Go Ahead! ”按钮 即 可 。 


E 
| 
| 


This project contains scripts and/or assemblies that use 


obsolete APIs. 


If you choose Go Ahead, Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 


before proceeding. 


(You can always run the API Updater manually via the 
Assets/Run API Updater' menu command.) 


I Made a Backup. Go Ahead! 


在 导入 完成 后 ，Project 窗 口中 显示 如 下 : 


Project 

Create + 

会 Favorites 
Q all Materials 
qQ all Models 
Q All Prefabs 
Q all Scripts 


Assets > 


Plugins 


8s Assets Editor 
Bs Editor 
8s Plugins 
Bs StreamingAssets 
бш Vuforia 


至 此 ，Vuforia SDK 已 经 成 功 导 入 了 新 建 的 Unity 项 目 中 ， 接 下 来 可 以 创建 开发 Demo。 


22 ”创建 Vuforia 案 例 


Thanks | 


Streaming... Vuforia license 3r.. 


在 开始 本 节 内 容 之 前 ， 如 果 你 还 没有 创建 Vuforia 账 号 ， 请 先 参照 上 一 节 完 成 注册 ， 如 果 你 已 经 是 Vuforia 开 发 者 ， 请 继续 阅读 接 下 来 的 内 容 。 


1. 获 取 License Key 


在 官网 点 击 Develop， 按 照 下 图 完成 操作 : 


Vuforia" Developer Portal 


Home Pricing Downloads Library Develop 


License Manager Target Manager 


License Manager 


Create a license key for your application. 


< 和 = 创建 一个 新 的 应 用 


support 


License Manager X Target Manager 


Back To License Manager 


Add License Key 
Application Name 


You can change this later 


Device 
Please select which device your арр will use 


Digital Eyewear 


License Key 


s Starter - No Charge 
Classic - $499 (one time fee) 
Cloud - Starting at 599/mo 


License Manager Target Manager 


License Manager 


Create a license key for your application. 


Add License Key 


Name Type Status v 


MyARTest Starter Active 
| 


完成 以 上 操作 后 ， 在 License Manager 中 点 击 自己 创建 的 应 用 名 称 ， 进 入 下 面 的 界面 : 


_Please select a license key. See pricing for details or contact us for custom options. 


Date Modified 


Apr O6, 2016 18:42 


License Manager > MyARTIest 


MyARTest Edit Name Delete License Key 


License Key 


Please copy the license key below into your app (valid only with Vuforia 4.2 or newer) 


AVto9er/////AAAAAefsigCh50H7nI-*7P5fDO0C*GlqgK6by27/VhL 
78dV6Pn7WifCZYXGBClKiIks/bq4eS7zAC5Q/EQQxKs7fTGCVPdg 
b9wz/RB4*cLoo9WJ4c5zJAzlvycaapVqgHWP//sXtSkplny/X5RqU 
88kMN9gr/QEyGuyzuzvJ9jaNY766bs3uAFiroeZpooxCOl9rY7Bl 
bYllEU*sy3pJoLeVmC4HdVhGZHltkdXkXpUtJ7TaxBOUMeoN2M1O 
CkcHZKlw9ahsq9a/6UcFh*NK8000HswSa6NFIkEtt7At-v37Dk3h 
gL3zPUSLSzHÁABfZLOlluw557jhh7FGLtmDTiUunWl4yFYDfRZOUC 
ODKqgCrSf8hjGZhmF 


View Vuforia 4 license key 
Device: Mobile 
Type: Starter 


Status: Active 生成 HJ License Key 
Created: Apr 06, 2016 18:42 


2. 导 出 新 建 应 用 的 数据 包 


根据 下 图 先 创建 一 个 新 的 数据 库 : 


Vuforia" Developer Portal 


Home Pricing Downloads Library Develop Support 


License Manager | Target Manager 


Target Manager 


Use the Target Manager to create and manage databases and targets. 


ELIGE rd га FH IR Hn a А: BE 
一 为 创建 的 新 应 用 添加 一 个 数据 库 


Create Database 


Name: 


数据 库 名 称 


Create 


数据 包 名 最 好 与 新 建 的 应 用 名 相同 ， 以 便于 后 期 查找 和 导出 。 创 建 好 之 后 进入 以 下 界面 : 


Target Manager 


Use the Target Manager to create and manage databases and targets. 


Add Database | 


Database Targets Date Modified 


MyARTest f. Apr 08, 2016 23:47 


VuforiaARDemo 0 Apr 12, 2016 00:53 


打开 新 建 的 数据 包 ， 添 加 识别 目标 : 


Target Manager > VuforiaARDemo 


VuforiaARDemo Edit Name 
Type: Device 


Targets (O) 


— 


Target Name 


Status v Date Modified 


本 书 选择 Single Image (单个 图 像 ) 作为 识别 图 : 


Add Target 


Type: 


Choose File 


jpg or -png (max file size 2mb). | 
jpg or .png (max file size ) lmant DEA 


Width: 


Enter the width of your target in the scene units. The size of the target shall 
be on the same scale as your augmented virtual content. The target ' s height 
will be calculated automatically when you upload your image. 

Image # > 


Name: "4 (不 能 使 用 中 文 ) 


| 


Name must be unique to a database. When a target is detected in your 
application, this will be reported in the API. 


添加 成 功 后 会 显示 如 下 界面 : 


| Add Target | | Download Database (1) 


Target Name ting Status м Date Modified 


1lselected Delete 


Single Image | y Apr 13 2016 21:00 


上 图 中 的 星 号 表示 该 图 片 的 识别 度 ， 星 级 越 高 则 识别 度 越 高 。 勾 选 已 上 传 图 片 ， 下 载 并 导入 Unity 工 程 中 。 


Download Database 


1 of 1 active targets will be downloaded 
Name: 

VuforiaARDemo 

Select a development platform: 

O SDK (Eclipse, Ant, Xcode, etc.) 


导入 成 功 后 如 下 图 所 示 : 
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8 Vuforia 


在 Unity Project 视 图 下 选择 Vuforia 一 Prefabs 文 件 夹 ， 并 将 ARCamera 和 |mageTarget 两 个 预制 件 拖 入 层级 视图 Hierarchy 中 ， 同 时 将 场景 自 带 的 Main Сатега 


预制 件 ARCamera 上 带 有 AR 摄像 机 以 及 App 相 关 设置 ; 预制 件 mageTarget 代 表 一 张 识别 图 像 ， 并 且 带 有 识别 事件 处 理 等 相关 脚本 。 
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点 击 ARCamera， 在 Inspector 面 板 中 找到 License Key， 将 步骤 1 中 创建 应 用 时 生成 的 License Key 复 制 并 粘贴 到 该 区 域 。 
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Unfartunately there is no profile for your 
webcam model: 'integrated Webcam', 
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ARCamera 设 置 完 成 后 点 击 ImageTarget， 按 照 下 图 进行 设置 : 
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Add Component 


右 击 ImageTarget 创 建 一 个 三 维 物 体 模型 ， 调 整 三 维 物 体 与 识别 图 像 的 位 置 关系 以 使 其 外 于 合适 位 置 。 
最 后 ， 点 击 运行 来 测试 效果 。 


至 此 ， 一 个 简易 的 Vuforia 案 例 创 建成 功 。 
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23 ”创建 AR 视频 
本 节 将 介绍 AR 视 频 的 创建 ，AR 视 频 即 识别 某 张 图 像 并 播放 与 所 识别 图 像 对 应 的 视频 文件 ， 一 般 用 于 企业 宣传 册 、 广 告 、 书 籍 等 相关 领域 。 我 们 将 会 继续 使 用 Unity 和 Vuforia SDK 来 开发 AR 视频 应 用 ， 
关于 Vuforia SDK 的 相关 配置 可 参阅 前 面 的 章节 。 


Unity 默 认 支 持 的 视频 格式 分 别 有 .mov、.mpg、.mpeg、.mp4、.avi 和 .asf， 我 们 在 项 目 应 用 中 一 般 采 用 .mp4 文 件 进行 视频 的 播放 。 在 本 节 中 ， 我 们 将 介绍 一 款 用 于 移动 手机 视频 播放 的 Unity 插 件 ， 
该 插件 名 为 Easy Movie Texture， 通 过 简单 的 设置 即 可 完成 视频 的 播放 。 


1 .插件 导 入 


下 载 Easy Movie Texture 2.36 插 件 并 导入 Unity 中 ， 在 EasyMovieTexture 文 件 夹 下 找到 VideoManager 预 制 件 并 将 其 放置 到 层级 视图 Hierarchy 中 ， 将 VideoManager 作 为 识别 图 像 的 子 物体 ， 该 预制 
件 可 以 将 视频 以 当前 面 片 (Plane) 的 大 小 比例 进行 播放 。 


c U Rs a. rri 
HERE 


在 Assets 文 件 夹 中 找到 StreamingAssets 文 件 夹 ， 将 视频 文件 放 在 该 文件 夹 下 。 如 果 Assets 中 没有 该 文件 夹 ， 则 需要 手动 创建 该 文件 夹 ， 如 果 视 频 放 在 其 他 文件 夹 下 ， 将 无 法 加 载 视频 。 


选中 VideoManager， 在 Inspector 面 板 的 Str File Name 选 项 中 填 入 视频 名 称 ， 如 a.mp4。 该 组 件 还 可 以 设置 是 否 自动 播放 (B Auto Play) 、 是 否 循环 播放 (B Loop) 等 属性 。 该 预制 件 本 质 上 是 一 
个 面 片 和 控制 播放 的 Media Player Ctrl 组 件 ， 所 以 可 以 手动 调整 面 片 相 对 于 识别 图 的 大 小 和 位 置 。 
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Setting 105 scripting backend to 1L2CPP to enable 64bit support. 


(1) Easy Movie Texture 揪 件 不 支持 PC 端的 视频 播放 ， 只 支持 Android 操 作 系统 和 iOS 平 台 。 


(2) 如 果 需 要 从 网 络 加载 视 频 文件 ， 则 只 需 将 视频 文件 的 网 络 URL 添 加 到 Str File Name 属 性 上 ， 无 需 其 他 操作 。 


N 
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本 节 介 绍 如 何 使 用 Vuforia 和 Unity 实 现 文字 识别 功能 。Vuforia 对 文字 识别 有 一 定 的 要 求 ， 首 先 ，Vuforia 能 够 识别 的 文字 大 多 为 英文 ， 不 能 识别 数字 和 中 文 。 其 次 ， 默 认 能 够 识别 的 英文 单词 必须 是 官 
方 词 库 中 的 单词 (10 万 个 ) ， 当 然 ， 还 可 以 自 定义 添加 英文 单词 。 接 下 来 我 们 通过 Vuforia 官 方 自 带 的 案例 来 看 一 下 文字 识别 的 实现 步骤 。 


登录 Vuforia 官 网 ， 在 下 载 页 面 中 找到 Samples， 该 页 面 中 有 Vuforia SDK 提 供 的 基本 功能 对 应 的 案例 ， 下 载 下 图 所 示 文 件 。 


Pricing Downloads Library Develop 


SDK Tools 


Core Features Download for Android 
vuforia-samples-core-android-5-5-8.zip (26.06 MB) 


These samples show how to build apps using the following i()& | Download for iOS 


care feature pl Vüfaria vutoria-samples-core-ios-5-5-8.zip (31.98 MB) 


Download for Unity 


object Pesognition vuforia-samples-core-unity-5-5-8.zip (374.07 MB) 


Image Targets 
Cylinder Targets Release Notes 
Multi Targets 
User Defined Targets 
Smart Terrain (Unity only) 
• Cloud Recognition 
e Frame Markers 
• Virtual Buttons 


下 载 并 解压 之 后 找到 下 图 所 示 Unity 包 并 导入 。 


< CloudReco-5-5-9.unitypackaqe 2016/3/5 0:58 UNITYPACKAGE ... 39 899 KB 
4| CylinderTargets-5-5-9.unitypackage 2016/3/5 0:59 UNITYPACKAGE .. 37,805 KB 
&| FrameMarkers-5-5-9.unitypackage 2016/3/5 1:00 UNITYPACKAGE .. 35,875 KB 
ЫЈ ImageTargets-5-5-9.unitypackage 2016/3/5 1:01 UNITYPACKAGE .. — 41,791 KB 
号 MultiTargets-5-5-9.unitypackage 2016/3/5 1:03 UNITYPACKAGE .. 38,318 KB 


16) ObjectRecognition-5-5-9.unitppackage 2016/3/5 1:04 UNITYPACKAGE .. 35,419 KB 
4 SmartTerrain-5-5-9.unity ] 2016/3/5 1:07 UNITYPACKAGE ... 39,708 KB 
9 TextReco-5-5-9.unitypackage 2016/3/5 1:09 UNITYPACKAGE ... 38,983 KB 
“ТЯ UserDefinedTargets-5-5-9.unitypacka.. 2016/3/5 1:10 UNITYPACKAGE .. 35,621 КВ 
|4) VirtualButtons-5-5-9.unitypackage 2016/3/5 1:12 UNITYPACKAGE .. 39,634 KB 


如 果 在 导入 Unity 揪 件 包 的 过 程 中 出 现下 图 所 示 的 对 话 框 ， 上 点击 “1 Made a Backup.Go Ahead! ”按钮 即 可 。 


This project contains scripts and/or assemblies that use 
obsolete APIs. 


If you choose Go Ahead, Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 


before proceeding. 


(You can always run the API Updater manually via the 
‘Assets Run АРІ Updater' menu command.) 


| Mo Thanks | 


2. 实 现 文 字 识别 
插件 包 成 功 导入 Unity 工 程 后 删除 场景 自 带 的 Main Camera， 同 时 在 Vuforia 文 件 夹 中 找到 如 下 文件 ， 拖 到 层级 视图 Hierarchy 中 。 
选择 场景 中 新 添加 的 TextRecognition 物 体 ， 在 Inspector 面 板 中 添加 Text Event Handler 脚 本 。 


在 Inspector 面 板 中 ，Additional Word File 表 示 添 加 自 定义 词 库 ， 类 型 为 .vwlI 文 件 。 上 图 中 ， 在 第 二 个 线 框 标定 区 域 可 以 自 定义 添加 需要 识别 的 单词 ， 如 ARinChina。MaxSimultaneous Words 属 性 
是 指 最 大 同时 存在 的 物体 的 单词 。 
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Add Component 
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Add Component 


Black_List 表 示 黑 名 单 ， 即 将 某 个 单词 加 入 该 名 单 之 后 就 无 法 再 识别 ;相对 应 的 White_List 则 表示 白 名 单 ， 加 入 该 名 单 的 单词 会 优先 进行 识别 。 


点 开 Word， 将 子 对 象 Text 文 字 改 为 我 们 自 定义 的 文字 ARinChina， 并 在 场景 中 的 Word 物 体 下 创建 一 个 识别 之 后 要 显示 的 物体 ， 然 后 调整 其 位 置 和 大 小 ， 比 如 创建 一 个 Cube， 最 后 运行 并 查看 识别 效 
Ж. 


Vuforia SOKET ЕЕЕ ИЧАЯ 88, АЯН, Bo ЫЕ ЖШН б ОЯН ТАЕ), AMRIH. 27А АУЗУ RI 7A. 


登录 Vuforia 官 网 ， 进 入 Downloads 页 面 ， 点 击 Samples 选 项 ， 然 后 下 载 如 下 插件 并 解压 。 


Home Pricing Downloads Library Develop 


SDK Samples Tools 


Core Features 


These samples show how to build apps using the following 


Download for Android 
vutoria-samplas-core-android-5-5-8.zip (26.06 МЕ) 


Download for 105 


vutoria-samplas-core-ins-E-E-O. zip (31.98 ME) 


core features of Vuforia. 


s Object Recognition 

e Image Targets 

= Multi Targets 

e User Defined Targets 
Smart Terrain CUnity only) 
Cloud Recognition 

' Text Recognition 
Frame Markers 


s Virtual Buttons 


在 解压 完成 后 找到 Cylinder Targets 包 并 导入 Unity 工 程 。 


在 Project 视 图 中 的 Vuforia 文 件 夹 下 找到 ARCamera 预 制 件 和 CylinderTarget 预 制 件 ， 将 这 两 个 预制 件 拖 至 层级 视图 Hierarchy 中 ， 同 时 删除 场景 中 的 Main Camera, 


— 


i$; CloudReco-5-5-9.unitypackage 


本 | ImageTargets-5-5-9.unitypackage 


< MultiTargets-5-5-9.unitypackage 


| ObjectRecognition-5-5-9.unitypackage 
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9 TextReco-5-5-9.unitypackage 
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EJ VirtualButtons-5-5-9.unitypackage 


Download for Unity 


vutoria-samples-core-unity-5-5-9.zip (372,07 MB) 


Release Notes 
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2016/3/5 1:01 
2016/3/5 1:03 
2016/3/5 1:04 
2016/3/5 1:07 
2016/3/5 1:09 
2016/3/5 1:10 
2016/3/5 1:12 
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2. 创 建 数据 库 
在 Vuforia 官 网 的 Develop 页 面 下 创建 一 个 新 的 数据 库 ， 命 名 为 CylinderTargets。 
创建 完成 后 打开 CylinderTargets 数 据 库 ， 选 择 Add Target， 在 弹出 的 文件 选项 面板 中 选择 第 三 种 Cylinder， 然 后 按照 页 面 要 求 填写 圆柱 体 的 尺寸 。 其 中 的 三 个 属性 分 别 代表 圆柱 体 的 以 下 信息 : 
: Bottom Diameter: 底面 直径 。 
: Top Diameter: 顶 面 直径 。 


: Side Length: 边 长 。 


Add Target 


Type: 


Cylinder 


Dimension: | E P ml jh: W £ 


Bottom Diameter. 0.5 


Single Image 


Top Diameter: 0.5 I 


Enter the dimensions of your target in scene units. The size of your target shall 
be on the same scale as your augmented virtual content. If you enter ‘©? for the 
top or bottom diameter, your target will be cone shaped. 

Name: 
| 


Name must be unique to a database. When a target is detected in your 
application, this will be reported in the API. 


Cancel Add 


在 创建 好 识别 目标 后 ， 点 击 新 创建 的 识别 目标 ， 然 后 选择 Upload Image 来 上 传 图 片 ， 这 个 图 片 是 指 包 囊 在 圆柱 体 上 的 识别 图 案 。 


| Choose File | Browse... 


File must be à or 24 bit PNG or JPG. JPG must be RGB or greyscae. Max 
size ig 3 МЕ. 


图 片上 传 标准 : 
- KË: Top Diameter. (或 者 Bottom Diameter) Xx. 


ХА: 按照 具体 圆柱 高 度 确 定 ， 本 书 使 用 可 口 可 乐 易 拉 钠 ， 所 以 宽度 为 易 拉 钠 高 度 11.5cmo。 
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接 下 来 ， 在 CylinderTarget 下 创建 一 个 子 物 体 模型 ， 这 里 选择 Shpere， 然 后 调节 到 合适 的 位 置 及 大 小 。 


"MPivot  ""Local | 
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î Project B Console 


最 后 ， 点 击 运行 以 测试 圆柱 体 识别 的 效果 。 


26 NRE 
Vuforia SDK 提 供 了 立方 体 识别 功能 ， 该 功能 可 以 识别 被 图 案 包 衷 的 立方 体 ， 常 用 于 产品 包装 盒 等 物体 的 AR 展示 效果 ， 本 节 我 们 将 介绍 通过 Unity 以 及 Vuforia SDK 制 作 立 方 体 识别 的 步骤 和 方法 。 


1. 下 载 并 导入 插件 


登录 官网 ， 点 击 下 载 如 下 插件 并 解压 。 


Home Pricing Downloads Library Develop Support 


Core Features Г Download for Android 


vuforia-samples-core-android-5-5-8.zip (26.06 МВ? 


These samples show how to build apps using the following iOS Download for iOS 

cre TasturEi doin vufaria-samples-core-ios-5-5-8.zip (31.98 MB) 
zT Download for Unity 

* шел Recognita vutoria-samples-core-unity-5-5-9.zip (374.07 MB) 

e Image Targets 


linder Targets Release Notes 


e Multi Targets 


e User Defined Targets 


Smart Terrain (Unity only) 


Cloud Recognition 
Text Recognition 
Frame Markers 


Virtual Buttons 


在 解压 完成 后 找到 Multi Targets 包 并 导入 Unity 工 程 。 


16) CloudReco-5-5-9.unitypackage 2016/3/5 0:58 UNITYPACKAGE .. 39,899 KB 
'$| CylinderTargets-5-5-9.unitypackage 2016/3/5 0:59 UNITYPACKAGE .. 37,805 KB 
i$] FrameMarkers-5-5-9.unitypackage 2016/3/5 1:00 UNITYPACKAGE .. 35,875 KB 
i$] Soin iid: i -9-9- шурасы т: 1:01 UNITYPACKAGE .. 41,791 KB 


ЕЈ Океан оо дийн 5-5- P^ REC qu m 2016/3/5 1:04 UNITYPACKAGE .. 35,419 KB 
IS] SmartTerrain-5-5-9.unitypackage 2016/3/5 1:07 UNITYPACKAGE ... 39,708 KB 
18| TextReco-5-5-9.unitypackage 2016/3/5 1:09 UNITYPACKAGE ... 38,983 KB 
S| UserDefinedTargets-5-5-9.unitypacka.. 2016/3/5 1:10 UNITYPACKAGE .. 35,621 КВ 
E] VirtualButtons-5-5-9.unitypackage 2016/3/5 1:12 UNITYPACKAGE ... 39 634 KB 


在 工程 视图 Project 中 的 Vuforia 目 录 下 找到 ARCamera 和 MultiTargets 两 个 预制 件 ， 将 其 拖 到 层级 视图 Hierarchy 中 ， 同 时 删除 场景 中 的 Main Camera, 
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2. 创 建 数 据 库 


在 官网 的 Develop 页 面 下 选择 Target Manager 并 创建 一 个 新 的 Database， 命 名 为 MultiTarget。 点 击 新 建 的 MultiTarget 数 据 库 ， 在 弹出 的 文件 选项 面板 中 选择 Cuboid。 


Add Target 


Type: 


Single Image Cuboid Cylinder 3D Object 


Dimension: 


Width |80 | 


Length- | /5 | 


Enter the width, height and length of your target in the same unit as your 
augmentation. The size of the target shall be relative to the size of the 
augmented virtual content. 


Name: 


Name must be unique to a database., When a target is detected in your 
application, this will be reported in the APL 


Cancel Add 


上 图 中 ，Dimension 中 的 属性 是 为 了 确定 立方 体 的 尺寸 ， 分 别 为 宽 、 高 、 长 三 个 维度 的 尺寸 。 相 应 的 ， 物 体 的 长 度 对 应 Front、Bottom、Top 和 Back 识 别 图 的 长 度 ， 宽 度 对 应 Left、Top、Right 和 
Bottom 识 别 图 的 宽度 ， 高 度 则 对 应 Front、Left、Right 和 Back 识 别 图 的 宽度 。 遵 循 上 述 步骤 ， 各 识别 图 上 传 时 相对 应 位 置 的 尺寸 必须 一 致 ， 否 则 会 出 现 识别 图 无 法 上 传 的 问题 。 
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FlakesBox.Back scaled.jpg 
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3. 实 现 立方 体 识别 功 能 


这 里 我 们 使 用 官方 自 带 的 MultiTarget， 选 中 MultiTarget， 调 节 下 图 所 示 属 性 。 
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在 MultiTarget 下 创建 一 个 扫描 后 要 显示 的 模型 ， 我 们 可 以 创建 一 个 Unity 自 带 的 Cube 来 显示 识别 之 后 的 物体 ， 调 整 好 对 应 关系 后 点 击 运行 即 可 实现 立方 体 识 别 效果 。 


2.5 节 和 2.6 节 讲解 了 柱 体 识别 和 立方 体 识别 ， 这 两 节 的 内 容 都 只 是 针对 简单 几何 体 进行 识别 ， 在 本 节 中 ， 我 们 将 介绍 不 规则 三 维 愧 体 的 识别 步 又 和 方法 。 
1. 下 载 并 导入 插件 


登录 官网 ， 点 击 Downloads 下 的 Tools， 下 载 Vuforia Object Scanner (Vuforia 物 体 扫描 器 ) 。Vuforia Object Scanner 是 一 个 用 于 扫描 物体 表面 识别 点 信息 的 App， 只 支持 Android 操 作 系统 。 根 据 
官网 规定 ， 建 议 大 家 采用 Samsung Galaxy S5 和 Google Nexus 5 这 两 款 安 卓 手机 进行 操作 ， 当 然 也 可 以 党 试 使 用 其 他 Android 手 机 。 


Home Pricing Downloads Library Develop Support 


SDK  Sompes | E 


Vuforia Object Scanner 


The Vuforia Object Scanner allows you to create a target by scanning an object 
with an Android device. Simply install the app, place an object on the Vuforia 
scanning target, and start the scan. The app gives you real-time visual feedback 
on the scan progress and target quality and establishes a coordinate system so 
that you can build immersive experiences with precisely aligned digital content. 
The test mode allows you to evaluate the recognition and tracking quality within 
the app before you start any development. Complete instructions can be found in 


the quide. 


Note: the Vuforia Object Scanner ı5 only supported on the Samsung Galaxy 55 
and Google Nexus 5. 


e Download APK 
scanner-5-5-9.zip (8.81 MB) 


Release notes 


下 载 完毕 并 解压 后 会 得 到 以 下 两 部 分 内 容 : 
: Media X: 三 维 物体 扫描 图 ， 需 要 采用 A4 纸 打印 出 来 。 


scanner.apk: 用 于 三 维 物体 扫描 ， 需 要 安装 在 上 述 两 款 安 草 手机 中 。 


SDF Samples Tools 


Core Features Download for Android 
ü vuforia-samples-core-android-5-5-9.zip (26.06 MB) 


Download for iOS 


These samples show how to build apps using the following 
vuforia-samples-core-ios-b-5-9 zip (31.88 MB) 


core features of V uforia. 


== — ! Download for Unity 
dient heengniuon vutaria-samples-core-unity-5-5-9.zip (374.07 MB) 
Image Targets 


2. 扫 描 三 维 物 体 识别 信息 (点 云 数据 ) 


将 打印 出 来 的 纸张 放 在 桌面 上 ， 在 右上 和 角 华 标 区 域 放 置 需 要 识别 的 三 维 物 体 。 打 开 已 经 安装 的 扫描 数据 App，360" 扫 描 物体 后 将 生成 后 缀 名 为 .od 的 数据 文件 。 


Vuforia = 


3. 创 建 数据 库 


接 下 来 登录 Vuforia 开 发 者 官网 并 创建 数据 库 ， 这 次 我 们 选择 3D Object， 点 击 Browse 按 钮 选择 上 一 步 中 生成 的 数据 文件 。 


Add Target 


Type: 


Single Image Cuboid Cylinder ар Object 


File: 


Choose File 


File must be Vuforia Object Scanner data. For more information, see 
the Vuforia Object Scanner Application. 


Name: 


Name must be unique to a database, When a target is detected in your 
application, this will be reported in the АРІ. 


Cancel | | Add 


创建 成 功 后 点 击 下 载 数据 包 并 将 其 导入 Unity 工 程 。 
4 实现 三 维 物体 扫 摘 


在 Vuforia 文 件 夹 中 找到 ARCamera 和 ObjectTarget 两 个 预制 件 并 拖 到 层级 视图 Hierarchy 中 。 


& Project B Console 
Create = 
» Bs Plugins Assets » Vuforia » Prefabs » 
бш Prefabs _ SmartTerrain 
> Ёш Resources | | 
Bs Scenes аЬ дег ГЕШ 
Bs Scripts т C vlinderTarget 
Ёш Shaders Ф rrameMarker 
p Иш StreamingAssets е ImageTar get 
Т 89 Vuforia | x 
> Bu Editor | 
бш Fonts EN TextRecognition 
Materials — | Ф UserDefinedTargetBuilder 
bS Prefabs | m | Ө VirtualButton 
M тетет Ф word 
Ёш Materials 
р Su Scripts 
— Shaders 
Ёш Textures 


选择 ObjectTarget， 在 Inspector 面 板 中 选择 三 维 数据 包 。 


© unay - OtyectRecognition мету - DteeCRecogrytlior - PC, Mac Б Uns Sandane” < ОКО: ый ë o 
file Edit Aneis — GameOiyert Component — Vulona Window tsip 


lise 
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然后 在 ObjectTarget 下 创建 一 个 扫描 成 功 后 要 显示 的 子 对 象 ， 并 调节 到 合适 的 位 置 及 大 小 ， 在 此 我 们 直接 创建 Unity 自 带 的 三 维 模型 Sphere。 


最 后 点 击 运行 以 测试 三 维 物体 的 识别 效果 。 


28 RFI 
在 开发 项 目的 过 程 中 ， 当 我 们 需要 将 识别 图 放置 在 服务 器 后 台 而 不 是 App 内 部 的 时 候 ， 需 要 使 用 Vuforia 的 云 识 别 功 能 ， 在 本 节 中 ， 我 们 将 介绍 Vuforia 云 识别 的 实现 步骤 和 方法 。 


1. 创 建 License Key 


登录 Vuforia 开 发 者 官网 ， 点 击 Develop， 在 License Manager 下 面 创建 一 个 License Key, 该 License Key 是 为 了 验证 App 的 合法 性 。 


Home Pricing Downloads Library Develop Support 


cense Manager Target Manager 


License Manager 


Create a license key for your application. 


Add License Key 


2. 创 建 云 数据 库 


选择 上 图 中 的 Target Manager 选 项 ， 然 后 点 击 Add Database 来 创建 去 识别 数据 库 ， 在 下 图 中 选择 Cloud 即 可 添加 去 识别 目标 。 


Create Database 


Name: 


Type: 


Device 
& Cloud 


Select License Key 


MyARTest (Mobile) 


选择 刚才 创建 的 License Key, 
创建 好 之 后 打开 ， 选 择 添加 图 片 〈 与 本 地 图 片 识别 一 样 ) 。 
3. 下 载 插件 


点 击 官网 中 的 Downloads， 下 载 下 图 所 示 的 Unity 包 。 


Home Pricing Downloads Library 


Core Features 


Develop 


These samples show how to build apps using the following 


core features of Vuforia. 


Object Recognition 
Image largets 
Cylinder Targets 
Multi Targets 
User Defined Targets 
| Smart Terrain (Unity only) 
Cloud Recognition 
Text Recognition 
Frame Markers 
Virtual Buttons 


4. 创 建 Unity 工 程 


新 建 一 个 Unity 工 程 ， 命 名 为 CloudTest 并 打开 ， 解 压 下 载 好 的 插件 包 ， 找 到 Cloud Recognition 包 并 将 其 导入 Unity 工 程 。 


©) CloudReco-5-5-9.unitypackage 

($| CylinderTargets-5-5-9.unitypackage 
(9| FrameMarkers-5-5-9.unitypackage 
E ImageTargets-5-5-9.unitypackage 
号 MultiTargets-5-5-9.unitypackage 


©) ObjectRecognition-5-5-9.unitypackage 


号 | SmartTerrain-5-5-9.unitypackage 

©) TextReco-5-5-9.unitypackage 

号 UserDefinedTargets-5-5-9.unitypackage 
a) VirtualButtons-5-5-9.unitypackage 


导入 完成 后 在 Assets 文 件 夹 中 找到 Scenes 文 件 夹 并 打开 Vuforia-3-CloudReco 工 程 。 


选择 CloudRecognition， 在 Inspector 面 板 中 找到 Access Key 和 Secret Key， 通 过 这 两 个 密 钥 可 以 找到 云 连接 的 图 片 。 


Download for Android 
vuforia-samples-core-android-6-6-9.zip (25.06 MB) 


Download for iOS 
vufaria-samples-core-ios-5b-5-G.zip (3198 МВ) 


Releases Notes 


2016/3/5 0:58 
2016/3/5 0:59 
2016/3/5 1:00 
2016/3/5 1:01 
2016/3/5 1:03 
2016/3/5 1:04 
2016/3/5 1:07 
2016/3/5 1:09 
2016/3/5 1:10 
2016/3/5 1:12 


UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 
UNITYPACKAGE ... 


39,599 KB 
3/,805 KB 
35,875 KB 
41,791 KB 
38,318 KB 
35,419 KB 
39,708 KB 
38,983 KB 
35,621 KB 
39,634 KB 
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再 次 进入 Vuforia 开 发 者 官网 ， 在 Develop 选 项 下 找到 下 图 所 示 的 页 面 选 项 。 
Home Pricing Downloads Library Develop Support 
License Manager Target Manager 


Target Manager > CloudTest 


CloudTest Edit Name 


Type: Cloud 
License Key: Cloud Test 


Targets (D Database Access Keys 


Client Access Keys 
Access Key: 


ddüdi6dBiccdiO004cZicZfe8bf4492a/0d447650 
secret Key: 
Je34df68d3e875cb92aad9ba7dabbcc93599e2b1 


将 上 图 中 的 两 个 密 钥 分 别 复制 到 Unity 工 程 中 要 求 输 入 密 钥 的 地 方 。 


选择 ARCamera， 将 刚才 专 为 云 识别 创建 的 License Key 复 制 进去 。 


File Edit Assets GameObject Component Vuforia Window Help 
«© «cox El =a pivot "ioca Layers "| He i 

ЧЕ Hierarchy „ж 3# Scene s .= © Inspector 

Create < Shaded š ) - G _ V ARC amera Stabc 
Directional light Tag Untagged * Layer Osfauk 


: Prefab Select Revert Apply 


J Transform 
Position X 0 Y 400 


LJ Unity - Vufo a-3 CloudReco.unity - CloudTest - PC, Mac & Linux >tandalon 


ContentManage! x 0 


- 
I 


О; V Audio Listener 


В vuforiaBehavio 


App License Key AQIR s AAAAAU 
8Swz/fglk GBk6SOPS 
bidld$GUINcWh66m 


Max Simultaneou 

Max Simultaneous Ti 1 

Load Object Targets 

Camera Direction CAMERA DEFAULT š 
Mirror Video Back gr "DEFAUCT - 
World Center Mode "FIRST TARGET f 


roject Ш Console 
< m 办 
Clear Collapse Clear on Play Error Pause m V Digital Eyewear Behaviour , 


Trackable --- EMPTY lost ا‎ BDigitalEyewean o 
UnityEngine .Debug:Log( Object Eyewear Type None _ 


Cloud Reco «mitialized successfully B V Database Load Behaviour (M ©, 
UnityEngine .Debug:Log( Object " и 
yEngine С 10 g(( script BDatabaseLoade © 
Cloud Reco initiauzed successfully 
UnityEngine Debug:Log( Object B V video Background Manage Я ©, 
Ф Track able Fox found Enable video backgr ¥ 
UnityEngine .Debug:Log( Object Overflow geometry STENCIL 
ө Track able Fox lost Matte Shade: B ClippingMask 


UrvtyEngine Debug:Log( Ob 
I s ! 2 В V smart Terrain Tracker Behi ©, 


StopVufonria 一 
[t] ades ч Start Automabcally 
UnityEngine .Debug:Log(Obiec 


B V Device Tracker Behaviour M ©, 


Enable device pose t 


B V web cam Behaviour (Scrip ™ ©, 


Disable Vufona Play ^ 


最 后 运行 以 测试 云 识别 效果 ， 与 本 地 识别 的 区 别 是 ， 云 识别 测试 需要 设备 处 于 连 网 状态 。 


之 前 介绍 了 如 何 通过 扫 摘 单个 识别 图 或 物体 来 实现 增强 现实 ， 可 它们 都 是 相对 独立 的 ， 并 且 与 现实 场景 没有 互动 。 那 么 ， 如 何 使 通过 增强 现实 技术 加 载 出 的 模型 与 现实 场景 豆 动 呢 ? 这 就 要 用 到 本 节 介 


绍 的 SmartTerrain。 


访问 htt 


s/sdk， 进 入 如 下 界面 ， 并 下 载 Vuforia SDK 的 Unity 版 本 。 


S vulforia" Developer Portal 


Home Pricing Downloads Library Develop Support 


SDK Samples Tools 


Vuforia 5.5 SDK 


Use the Vuforia SDK to build Android and iOS applications for mobile 
devices and digital eyewear. Apps can be built with Android Studio 
(Јама/С++), XCode (С++), and Unity, the cross-platform game engine. 


Download for Android 
vufaria-sdk-android-5-5-Bzip (6.99 MB) 


Download for iOS 
vuforia-sdk-ios-5-5-8.zip C1 710 ME) 


Download for Unity 
vuforia-unity-b-b-G unitypackage (34.60 MB) 


Release Notes 


> 人 ||z 志 | Inin To 
2. 创 建 Unity 工 程 


新 建 一 个 Unity 工 程 并 将 下 载 好 的 插件 导入 Unity。 


A RA rg RA EE To T — eio 
©. 4 мл Ыш "3 Center “Local c ECO ` X Lav out 
H Scene € Game 
scene зате 
Shaded " 2D Ф: 4) ГӘ 
Main Camera 
Directional Light 


Project 
Create - 


83 Plugins 

条 Vuforia 

BB license 3rdpartynotice 
B linl 


B readme_sDk 


将 场景 中 的 Main Camera 删 除 ， 在 Vuforia 文 件 夹 下 的 Prefabs 里 将 ARCamera、lmageTarget 以 及 SmartTerrain 中 的 SmartTerrain 拖 入 场景 。 


在 Vuforia 的 Develop 页 面 中 的 License Manager F2XRXLicense Key 并 填 入 下 图 所 示 的 框 内 。 


Project а . = Hierarchy 
Create * Create < 
8n Plugins 
in Vuforia Directional Light 

Em Editor | Tad Fran 


== 7 5 
Fon > ARCamera 
бш Materials 2 


a- Prefabs | а JC | ar GF 
L SmartTerrain 


L d SmaitTerrain 
Р ARCamera 

CloudR ecognition 
Ф CylinderTarget 

FrameMarkei 
Ф ImageTarget 


Ф ObjectTarget 
| Te xtR ecognition 
Ф userDefinedTargetBuilder 
Ф VirtualButton 
Ld Word . 
ВЕ Resources Project 
fina Scripts Create - 
бш Shaders ; 
N бш Plugins 
B license_3rdpartynotice — Vuforia 
- link ЁЗ Editor 
readme SDKkK 
E S5 Fonts 


¿+= O Inspector 


v ARCamera ™ Static 
Tag 'Untagged +! Layer (Default + 
Prefab Select Revert — Apply ` 
A Transform w +, 
Position X 0 
Rotation X 0 
Scale X 1 Y Ë 
© V Audio Listener T Л 
[8 V vuforia Behaviour (Script) M +, 
B VuforiaBel 
App License Key 


Camera Device Mod MODE DEFAULT + 
Max Simultaneous Tı 1 

Max Simultaneous TI 1 

Load Object Targets ^^ 

Camera Direction "CAMERA DEFAULT + 
Mirror Video Backgr DEFAULT š 
World Center Mode 'FIRST TARGET 


然后 在 Target Manager 页 面 中 上 传 一 张 识别 图 ， 下 载 识 别 目 标 数据 文件 并 将 其 导入 当前 工程 (关于 如 何 下 载 识 别 目 标 数据 ， 之 前 的 章节 中 有 详细 的 介绍 ) 。 


在 ARCamera 的 Inspector 面 板 中 进行 如 下 设置 。 


Project 
Create 
== Editor 
"= Plugins 


lx StreaminoAssets V ALANNE Load — (mr ss, 


= Vuforia 
Bh license 3rdpartynotice 


1971 
| ll 


Bb: 


EB inl Р ImageTest Dat Y 
== readme_SDKk Activate T 


B V Vuforia Behaviour -— | t, 


Non License Key 


| | | ^ AcG+tkSTo0Dyig2T 
IB V smart Terrain Tracker BehllW #, mrKdoxWND5eG9AL 


Start Automatically í Camera Device Mod MODE DEFAULT $; 
ج ا‎ Max Simultaneous Tı 1 
actor that defines how a scene 
unit neei je scaled to be in real world 
millime 


Max Simultaneous Ti 1 
Load Object Targets Т 


jit should be 100mm in the Camera Direction CAMERA DEFAULT $ 


cale value tü 100,0 erede atta ر‎ EF learn sek E dta bn au > اا‎ - 
World Center Mode 'SPECIFIC TARGET * 
1000 | Worlg Center В Primary Surfac © 


在 ImageTarget 的 Inspector 面 板 下 进行 如 下 设置 。 


Y Image Target Behaviour (Sci M $5, 


аа! 


Image Target 


Height 0.052901 


Preserve child size 


acking cannot be enabled at 
Smart Terrain, 


Enable Smart Terrall 
在 这 里 选择 你 的 识别 图 。 为 了 方便 观察 ， 我 们 改变 一 下 SmartTerrain 中 组 件 的 材质 颜色 ， 步 骤 如 下 。 


Project 
Create * 
бш Editor 
ш Plugins 
Š 8s StreamingAssets 
Image Target logo Bm Vuforia 
Width 0.1468 = Hierarchy | ® Editor 
Height 0.052901 Create - | Өш Fonts 
| | | ® Materials 
Directional Light ® CloudRecoTarget 


V Image Target Behaviour (tB #, 
BBImageTargetBe 

Type Predefined 

Database ImageTest 


Preserve child size 


"d 


Extended Tracking cannot be enabled at mati eri E ColoredLines 


the same time as Smart Terrain. Primary Surface B DefaultTarge? 
: | it ospthMask 
| Extel pm Prop Template е DepthMask 
Жат ! ® EmulatorvideoBackground 
Enable Smart Terrais NEW Beh н el D ° StencilClipping 
а ارا وو‎ hot ® UserDefinedTarget 
Press 'HEW' to instantiate a new Smart Terrain ff videoMaterial 
prefab in the scene, йш Prefabs 


Smart Terrain Instar @ SmartTerrain © Bm Resources 
| - - Bs Scripts 
Change these values to the size of the object ac ү? 
you initialize from, e.g. if there is a border mm Shaders 

around your target. Bs Textures 


- link 


В readme SDK 


n n?»oanac 


将 这 个 材质 球 赋 给 上 面 的 Primary Surface， 并 设置 如 下 。 然 后 对 PropTemplate 的 材质 进行 设置 。 


ColoredLines LESS 
Shader 'Transparent/VertexLit witt» 


Main Color 
غ‎ 


Base (RGB) Trans (А) Hone 
(Texture) 


Tiling 
Offset х D Y t Select 


颜色 可 自由 选择 ， 没 有 特殊 规定 。 


运行 Unity 扫 描 识 别 图 ， 并 在 场景 中 置 入 一 个 随机 物体 ， 效 果 图 如 下 。 


propMat LE: 
Shader !Transparent/VertexLit with r | 


Main Color Шш / 


Base (RGB) Trans (А) None 
(Texture) 


Tiling 
Offset | Select 


扫描 成 功 后 会 出 现 暗 紫色 的 阴影 部 分 ， 随 后 如 果 扫 描 出 了 场景 中 的 三 维 物体 ， 就 会 在 该 物体 上 生成 一 个 浅 绿色 的 立方 体 盒子 (不同 设置 下 的 颜色 不 同 ) 。 


至 此 ，Vuforia 的 SmartTerrain 地 形 就 创建 完毕 ， 大 家 可 以 根据 自己 的 需求 在 出 现 浅 绿色 立方 体 盒子 的 地 方 添加 相应 的 模型 与 交互 事件 ， 从 而 完善 你 的 smartTerrain 应 用 。 


< У 注意 


若 想 实现 更 好 的 效果 ， 还 可 以 结合 PrimeSense Capti 进 行 开 发 。 


2.10 ”虚拟 按钮 


使 用 Vuforia 实 现 增 强 现 实 之 后 ， 有 时 需要 与 这 些 虚 拟 模型 进行 交互 ， 同 时 为 了 使 交互 方式 更 加 魔幻 ， 我 们 期 望 可 以 在 真实 的 识别 图 像 上 进行 点 击 ， 从 而 触发 App 中 的 某 些 行为 。Vuforia SDK 为 我 们 提 


fit f Virtual Button 功 能 来 实现 这 样 的 交互 ， 本 节 我 们 将 带领 大 家 使 用 这 一 特性 实现 两 个 模型 之 间 的 切换 。 


1. 插 件 下 载 


访问 https://developer.vuforia.com/downloads/sdk， 进 入 如 下 界面 ， 并 下 载 Vuforia SDK 的 Unity 版 本 。 


= vulforia" Developer Portal 


Home Pricing Downloads Library Develop Support 


SDK Samples Tools 


Vuforia 5.5 SDK 


Use the Vuforia SDK to build Android and iOS applications for mobile 
devices and digital eyewear. Apps can be built with Android Studio 
(Шама/С++), XCode (С++), and Unity, the cross-platform game engine. 


Download for Android 
vuforia-sdk-andraid-5E-5-8.zip (6.99 MB) 


Download for 105 
vuforia-sdk-ios-5-5-Szip CT710 MB) 


Download for Unity 
vufaria-unity-5-5-8 unitynackage C34. 50 MB) 


Release Notes 


2. 创 建 Unity 工 程 


新 建 一 个 Unity 工 程 并 将 下 载 好 的 插件 导入 Unity， 同 时 将 识别 图 数据 包 导入 该 工程 。 


3. 场 景 搭建 


首先 删除 场景 中 的 Main Camera， 接 着 从 Vuforia 一 Prefabs 中 将 ARCamera 和 ImageTarget 拖 入 场景 ， 在 ARCamera 的 Inspector 面 板 下 添加 App License Key， 并 激活 当前 识别 图 信息 。 
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World Center Mode | FIRST TARGET : 


| M Digital Eyewear Behaviour Q| # 
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App License Key 
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vicis W Default Initialization Error i] e 
- Defaultinitializz 


然后 在 ImageTarget 的 Inspector 面 板 下 设置 相应 识别 图 信息 。 


接着 在 ImageTarget 下 分 别 创建 一 个 Cube 和 一 个 Sphere， 并 将 Project 视 图 中 Vuforia 一 Prefabs 下 的 Virtual Button 预 制 件 拖 入 ImageTarget。 这 里 将 Cube 的 棱 长 设置 为 0.3， 将 Sphere 的 半径 设置 为 


0.4， 然 后 使 它们 的 位 置 相同 。 为 了 便于 观察 ， 我 们 新 建 两 个 材质 球 ， 分 别 将 Cube 和 Sphere 设置 为 不 同 的 颜色 。 最 后 在 Virtual Button 的 Inspector 界 面 里 分 别 设置 两 个 Virtual Button 的 名 字 。 


Y |&| M Image Target Behaviour (Scr. ** Y ... М Mesh Renderer 
Script = ImageTargetBeha © Cast Shadows | 
| Receive Shadows [w 


Type Predefined $ 
> Materials 
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Image Target м 
| g stones * | | | 
dii SML =—— чанараа Reflection Probes 


Width ы Anchor Override [None (Transform) | © 
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Height TUN шшш, v [c MÎ virtual Button Behaviour (Scil. 

Preserve child size [ | Script VirtualButtonBeha © 


Enable Extended Tral | [showCube 
Enable Smart Тегга! | Sensitivity Setting ом — . t| 


4. 脚 本 编写 


在 Project 下 新 建 一 个 C# 脚 本 ， 命 名 为 VirtualButtonTest.cs， 并 在 脚本 中 添加 以 下 代码 : 


using UnityEngine; 

using System.Collections.Generic; 

using Vuforia; 

public class VirtualButtonTest: MonoBehaviour,IVirtualButtonEventHandler 


{ 


void Start () 

{ 

} 

public void OnButtonPressed(VirtualButtonAbstractBehaviour vb) { } 
public void OnButtonReleased(VirtualButtonAbstractBehaviour vb) { } 


该 类 的 作用 是 实现 IVirtualButtonEventHandler 这 个 接口 ， 该 接口 中 定义 了 OnButton Pressed 和 OnButtonReleased 两 个 方法 ， 这 两 个 方法 能 够 监听 虚拟 按键 的 按 下 和 释放 事件 。 为 了 触发 这 两 个 事 
件 ， 我 们 还 需要 将 之 前 添加 的 两 个 VirtualButton 对 象 注册 到 事件 系统 中 ， 因 此 需要 在 Start() 方 法 中 查找 这 两 个 物体 ， 并 调用 VirtualButtonBehaviour 类 中 的 RegisterEventHandler 方 法 将 当前 对 象 作为 参数 
传 入 ， 具 体 的 代码 实现 如 下 : 


void Start () 
{ 

// 在 所 有 子 物体 类 中 找到 所 有 VirtualButtonBehaviour 组 件 

VirtualButtonBehaviour[] vbs = GetComponentsInChildren«VirtualButtonBehaviour» (); 
for (inti = 0; i < vbs.Length; ++i) 


// 在 虚拟 按钮 中 注册 TrackableBehaviour 事 件 


vbs[i].RegisterEventHandler (this); 


} 


接 下 来 在 当前 类 中 创建 两 个 GameObject 类 型 的 字段 ， 分 别 对 应 之 前 创建 的 立方 体 和 球体 。 


private GameObject cube; 
private GameObject sphere; 


接着 在 Start 方 法 中 查找 这 两 个 物体 并 赋值 给 相应 的 字段 。 


cube = transform.FindChild ("Cube").gameObject; 
sphere = transform.FindChild ("Sphere").gameObject; 


在 程序 开始 的 时 候 ， 我 们 希望 它们 都 不 显示 ， 所 以 要 先 把 它们 藏 起 来 。 这 就 是 start 方 法 的 最 后 一 步 需 要 做 的 事情 : 


cube.SetActive (false); 
sphere.SetActive (false); 


现在 我 们 开始 实现 OnButtonPressed 方 法 中 的 功能 ， 此 方法 的 唯一 一 个 参数 vb 是 VirtualButtonAbstractBehaviour 类 型 。 在 这 个 参数 中 可 以 获取 被 按 下 的 虚拟 按键 的 名 称 VirtualButtonName， 将 传 
递 的 名 称 和 场景 中 创建 的 名 称 进行 对 比 ， 就 可 以 知道 我 们 具体 按 下 的 是 哪 一 个 虚拟 按键 ,具体 代码 实现 如 下 : 


switch (vb.VirtualButtonName) 
{ 


case "showCube": 
cube.SetActive (true); 
break; 

case "showSphere": 
sphere.SetActive (true); 
break; 


同 理 ，OnButtonReleased 实 现 方法 基本 相同 ， 代 码 如 下 : 


switch (vb.VirtualButtonName) 
{ 


case "showCube": 
cube.SetActive (false); 
break; 

case "showSphere": 
sphere.SetActive (false); 
break; 


e: 


} 


zs 
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运行 Unity 并 扫描 识别 图 ， 由 于 我 们 在 最 开始 将 两 个 物体 隐藏 起 来 了 ， 所 以 看 不 到 东西 。 
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当 我 们 “ 按 下 ”左边 的 showCube 按 钮 时 ， 画 面 如 下 。 


接着 ,我 们 “ 按 下 ”右边 的 showSphere 按 钮 ， 效 果 如 下 。 


到 此 ，VirtualButton 功 能 实现 完毕 。 


关于 虚拟 按钮 ， 有 以 下 几 点 需要 注意 : 
本 节 只 是 实现 了 一 个 简单 的 功能 ， 大 家 可 以 根据 自己 的 需求 自 定义 VirtualButton 事 件 。 


: 可 以 使 用 PS 等 图 像 处 理 软件 给 识别 图 加 上 虚拟 按钮 的 图 像 ， 这 样 会 更 直观 。 


° 为 了 达到 更 好 的 体验 效果 ， 识 别 图 可 以 复杂 一 些 ， 尤 其 是 在 虚拟 按钮 的 位 置 。 


2.11 帧 标记 识别 


在 使 用 Vuforia 进 行 开发 时 ， 我 们 总 是 强调 识别 图 的 识别 度 星 级 越 高 ， 越 容易 识别 。 那 么 假如 在 商业 项 目 中 ， 客 户 要 使 用 的 识别 图 的 识别 星 级 为 0， 该 怎么 办 呢 ? 这 就 是 FrameMarker 大 展 拳脚 的 时 候 
了 。 本 节 我 们 将 为 大 家 介绍 一 个 名 叫 FrameMaker 的 神奇 功能 。 


1. 插 件 下 载 


访问 https://developer.vuforia.com/downloads/sdk， 进 入 如 下 界面 ， 并 下 载 Vuforia SDK 的 Unity 版 本 。 


令 Vulforia" Developer Portal 


Home Pricing Downloads Library Develop Support 


Vuforia 5.5 SDK 


Use the Vufaria SDK to build Android and iOS applications for mobile 
devices and digital eyewear. Apps can be built with Android Studio 
(Java/C*4), ХСоде (С++), and Unity, the cross-platform game engine. 


Download for Android 
vuftoria-sdk-android-5-5-3zip (6.33 MB) 


Download for 105 
vuftaria-sd&-ins-5-5-9. zip 0710 МВ) 


Download for Unity 
vuftoria-unity-5b-b-Q.unitypacksge (34.50 MB) 


Release Notes 


2. 创 建 Unity 工 程 


使 用 插件 © wforiacunity-5-5-9.uniypackage 。 ”导入 新 建 的 Unity 工 程 。 
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然后 拖 入 ARCamera 和 FrameMaker， 并 在 FrameMaker 下 新 建 一 个 Cube 作 为 识别 后 呈现 的 对 象 。 


3. 效 果实 现 


在 ARCamera 里 填写 App License Key， 识 别 效 果 如 下 。 
Cr ‚о & All 


Directional Light 
ARCamera 
FrameMarkerü 


Cube 


这 里 要 说 明 的 是 ， 其 实 FrameMaker 和 ImageTarget 识 别 很 像 ， 但 是 ，ImageTarget 识 别 需 要 先 将 识别 图 上 传 到 Vuforia， 再 从 资源 库 中 以 .unitypackage 格 式 下 载 并 导入 工程 中 使 用 。 而 FrameMaker 
则 无 需 上 传 ， 官 方 提供 了 512 张 FrameMaker 的 识别 图 供 使 用 。 


所 以 当 我 们 使 用 ImageTarget 的 时 候 要 在 ARCamera 上 勾 选 如 下 设置 ， 而 使 用 FrameMaker 的 时 候 则 无 需 设置 。 
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所 以 我 们 在 制作 的 时 候 ， 只 需 使 用 PS 将 自己 的 识别 图 和 官方 提供 的 FrameMaker 进 行 合成 即 可 ， 因 为 所 识别 的 是 帧 识别 图 ， 与 底 图 内 容 无 关 。 但 要 注意 一 点 ， 你 所 使 用 的 帧 识别 图 的 序号 
FrameMaker 中 进行 设 定 ， 默 认为 0 ( 即 第 一 张 ) 。 
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官方 提供 的 识别 图 已 打包 好 ， 解 压 后 可 直接 使 用 ， 路 径 如 下 。 
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所 以 当 我 们 遇 到 识别 图 不 清楚 、 识 别 效果 差 或 者 识别 图 较 多 又 相似 的 问题 时 ， 就 可 以 考虑 使 用 FrameMaker 来 解决 这 一 问题 ， 因 为 其 主要 是 识别 FrameMaker， 而 和 底 图 没有 关系 。 


这 就 是 帧 标记 识别 ， 快 使 用 它 让 那些 0 星 级 的 识别 图 “ 重 获 新 生 ” 吧 ! 


在 AR 开发 过 程 中 ， 很 多 人 会 觉得 将 识别 图 上 传 到 官网 数据 库 然 后 再 从 数据 库 下 载 这 个 过 程 难免 有 些 繁琐 ， 尽 管 有 FrameMaker 和 云 识 别 这 些 强大 的 功能 ， 


定义 目标 识别 


实时 创建 识别 图 ， 就 是 本 节 我 们 要 给 大 家 介绍 的 新 功能 ， 自 定义 目标 识别 。 


1. 揪 件 1 


IT MEX 


但 还 是 会 有 人 


ГК | 
WAF 


麻烦 。 那 么 ， 如 何在 使 用 时 


有 必要 提前 介绍 一 下 自 定 义 目 标识 别 的 工作 原理 ， 打 开 摄 像 头 开始 扫描 后 ， 以 扫 摘 到 的 某 一 固定 场景 作为 识别 图 ， 实 现 这 一 步骤 的 方法 就 是 使 用 摄像 头 进行 拍照 ， 这 时 就 需要 一 个 触发 拍照 的 指令 ， 
们 用 一 个 Button 来 实现 。 所 以 最 终 的 效果 就 是 画面 中 会 一 直 有 一 个 Button， 当 我 们 扫描 到 我 们 要 自 定义 的 识别 图 时 ， 按 下 Button ， 然 后 识别 图 创建 完成 ， 扫 描 该 识别 图 ， 模 型 出 现 。 


访问 https://developer.vuforia.com/downloa 


ds/sdk, 进入 如 下 界面 ， 并 下 载 Vuforia SDK 的 Unity 版 本 。 


dE vulforicr Developer Portal 


Home Pricing Downloads Library Develop Support 


SDK Samples Took 


Vuforia 5.5 SDK 


Use the Vuforia SDK to build Android and iOS applications for mobile 
devices and digital eyewear. Apps can be built with Android Studio 
(Java/C4-). 4 Code (C++), and Unity, the cross-platform game engine. 


LI Download for Android 
vutoria-sdk-andraid-3-5-Ezip (5.39 MB) 


Download for 105 
vuforia-sdk-ios-5-b-3z2ip C710 MB) 


iOS 


Download for Unity 
vutorna-unity-5b-5-3 uritypackage 634,50 MB) 


Release Notes 


2. 创 建 Unity 工 程 
新 建 一 个 Unity 工 程 并 将 下 载 好 的 插件 导入 Unity。 
3. 场 景 搭建 


删除 场景 中 原 有 的 Main Camera， 接 着 从 Vuforia 一 Prefabs 路 径 下 将 ARCamera、lmageTarget 以 及 UserDefinedTargetBuilder 拖 入 场景 。 


接着 在 ARCamera 的 Inspector 面 板 下 添加 App License Key。 随 后 在 ImageTarge 的 Inspector 面 板 下 将 ImageTarget 类 型 设置 为 UserDefined。 


接 下 来 需要 添加 模型 ， 这 里 用 Cube 来 代替 ， 我 们 在 lImageTarget 下 添加 一 个 Cube。 最 后 创建 Button 按 钮 ， 这 也 是 我 们 创建 自 定义 识别 图 时 最 重要 的 一 步 。 


4. 编 写 脚本 


在 Project 下 新 建 一 个 C# 脚 本 ， 脚 本 主 框架 如 下 : 


using UnityEngine; 

using System.Collections; 

using System.Collections.Generic; 
using System. Linq; 
using Vuforia; 
public class UDTTest: MonoBehaviour,IUserDefinedTargetEventHandler 


{ 


void Start () 

| 

} 

public void OnFrameQualityChanged (ImageTargetBuilder.FrameQuality frameQuality) { ) 
public void OnInitialized() ( ) 

public void OnNewTrackableSource (TrackableSource trackableSource) ( ) 

public void BuildNewTarget () 

Í 

} 


这 个 类 中 比较 关键 的 是 IUserDefinedTargetEventHandler 这 个 接口 ， 其 中 定义 了 OnFrame QualityChanged、Onlnitialized 和 OnNewTrackableSource 三 个 方法 。 我 们 实 
并 将 脚本 附加 到 UserDefinedTargetBuilder 上 。 


首先 需要 声明 一 个 UserDefinedTargetBuildingBehaviour 类 型 的 变量 ， 接 着 在 Start 函 数 里 将 当前 类 注册 为 该 类 型 事件 。 


UserDefinedTargetBuildingBehaviour mTargetBuildingBehaviour; 
void Start () 
Í 


mTargetBuildingBehaviour = GetComponent<UserDefinedTargetBuildingBehaviour>(); 
if (mTargetBuildingBehaviour) 


{ 


mTargetBuildingBehaviour.RegisterEventHandler (this); 
Debug.Log("Registering User Defined Target event handler."); 


接 下 来 要 实现 接口 中 的 三 个 国 数 ， 首 先是 Onlnitialized， 用 来 初始 化 一 些 数 据 ， 我 们 在 这 个 函数 里 写 入 下 面 的 代码 : 


public void OnInitialized() 
{ 


mObjectTracker = TrackerManager.Instance.GetTracker«ObjectTracker» (); 
if (mObjectTracker !- null) 
{ 


mBuiltDataSet = mObjectTracker.CreateDataSet (); 
mObjectTracker.ActivateDataSet (mBuiltDataSet); 


这 里 用 到 两 个 新 的 变量 ， 需 要 提前 声明 ， 如 下 : 


ObjectTracker mObjectTracker; 
// 新 定义 的 数据 集 添加 到 DataSet 里 
DataSet mBuiltDataSet; 


接着 是 OnFrameQualityChanged 这 个 函数 ， 用 来 更 新 当前 帧 质量 。 我 们 在 函数 里 写 入 下 面 的 代码 : 


public void OnFrameQualityChanged (ImageTargetBuilder.FrameQuality frameQuality) 
{ 


mFrameQuality = frameQuality; 
if (mFrameQuality == ImageTargetBuilder.FrameQuality.FRAME QUALITY LOW) 
I 

Debug.Log("Low camera image quality"); 


) 


这 里 的 mFrameQuality 是 一 个 用 来 记录 当前 帧 图 像 质量 的 枚 举 类 型 ， 声 明 如 下 : 


ImageTargetBuilder.FrameQuality mFrameQuality = ImageTargetBuilder.FrameQuality.FRAME QUALITY NONE 


M 


最 后 也 是 最 重要 的 一 个 方法 OnNewTrackableSource 的 代码 如 下 : 


public void OnNewTrackableSource (TrackableSource trackableSource) 


{ 


mTargetCounter-Tt; 

// Deactivates the dataset first 

mObjectTracker.DeactivateDataSet (mBuiltDataSet); 

// Destroy the oldest target if the dataset is full or the dataset 

// already contains five user-defined targets. 

if (mBuiltDataSet.HasReachedTrackableLimit() || mBuiltDataSet.GetTrackables().Count() »- 5) 
{ 


Enumerable«Trackable» trackables = mBuiltDataSet.GetTrackables(); 
Trackable oldest = null; 
foreach (Trackable trackable in trackables) 


{ 


if (oldest == null || trackable.ID « oldest.ID) 
oldest = trackable; 
) 
if (oldest != null) 


Debug.Log("Destroying oldest trackable in UDT dataset: " + oldest.Name); 
mBuiltDataSet.Destroy(oldest, true); 


} 


// Get predefined trackable and instantiate it 

ImageTargetBehaviour imageTargetCopy = (ImageTargetBehaviour)Instantiate (ImageTargetTemplate); 
imageTargetCopy.gameObject.name = "UserDefinedTarget-" + mTargetCounter; 

// Add the duplicated trackable to the data set and activate it 

mBuiltDataSet.CreateTrackable (trackableSource, imageTargetCopy.gameCbject); 

// Activate the dataset again 
mObjectTracker.ActivateDataSet (mBuiltDataSet); 


P 


Fä 


这 个 函数 里 需要 提前 声明 的 变量 有 两 个 ， 如 下 : 


int mTargetCounter; 
// 上 声明 一 个 公开 的 ImageTargetBehaviour， 然 后 在 Unity 中 赋值 
public ImageTargetBehaviour ImageTargetTemplate; 


最 后 一 个 就 是 我 们 自 定 义 的 函数 BuildNewTarget， 代 码 如 下 : 


у, 


现 这 


个 接口 中 的 三 个 方法 ， 


public void BuildNewTarget () 
1 


mTargetBuildingBehaviour.BuildNewTarget ("test", 50); 
) 


然后 还 需要 返回 Unity 中 进行 一 些 细微 的 设置 调整 ， 将 我 们 的 脚本 拖 到 UserDefined TargetBuilder 下 ， 并 为 ImageTargetTemplate 进 行 赋值 。 
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然后 在 Button 上 添加 点 击 事件 ， 步 又 如 下 。 
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SendMessage (string) 
SendMessageUpwards (string) 
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首先 拍摄 一 张 图 片 ， 界 面 如 下 。 


Vuforia 


将 我 们 需要 自 定 义 的 识别 图 置 于 取景 框 内， 点 击 Button 便 可 识别 出 Cube， 将 识别 图 移出 摄像 头 取景 学 围 ， 模 型 消失 ， 再 次 扫描 刚才 的 识别 图 ， 依 然 出 现 模型 。 
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至 此 ，Vuforia 的 自 定 义 目标 识别 介绍 完毕 ， 大 家 可 以 根据 自己 的 需求 发 挥 想 象 力 ， 制 作出 属于 自己 的 炫 酷 AR 产 品 。 
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在 第 2 章 中 我 们 实现 了 通过 Vufoira 默 认 方 式 识 别 并 显示 三 维 模型 。 默 认 的 加 载 模型 是 通过 将 3D 物 体 直 接 放置 在 场景 中 并 作为 识别 目标 的 子 物体 来 实现 的 ， 这 种 实现 方式 的 问题 是 ， 当 场景 中 有 很 多 识别 
目标 后 ， 需 要 一 次 性 加 载 的 模型 内 容 会 占用 很 大 的 内 存 。 因 此 ， 在 实际 项 目 案例 中 需要 动态 加 载 识 别 目标 对 应 的 模型 ， 在 识别 丢失 之 后 删除 模型 ， 这 样 可 以 保证 同一 时 刻 内 存 的 占用 是 手机 可 以 承受 的 。 


本 节 将 通过 预制 件 实例 化 的 方式 实现 AR 模型 的 动态 加 载 和 显示 。 


将 ImageTarget 下 调整 好 的 模型 拖 到 最 上 层 ， 和 ImageTarget 在 层级 视图 中 保持 平 级 关系 。 
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在 Assets 目 录 中 创建 Resources 文 件 夹 ， 并 将 层级 视图 Hierarchy 中 的 模型 Sphere 拖 至 Resources 文 件 夹 中 ， 然 后 删除 层级 视图 Hierarchy 中 的 Sphere 模型 。 
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2. 为 需要 加 载 的 预制 件 添加 脚本 
在 工程 视图 Project 中 创建 一 个 新 的 C# 脚 本 ， 命 名 为 TrackObject.cs， 该 脚本 是 为 了 更 方便 地 找到 识别 后 显示 的 物体 ， 将 其 拖 到 需要 加 载 的 预制 件 上 。 


在 工程 视图 Project 中 找到 DefaultTrackableEventHandler.cs 这 个 脚本 ， 按 住 Ctrl+ D 可 以 复制 一 份 相同 的 脚本 ， 选 中 新 复制 出 来 的 脚本 并 按 F2 快 捷 键 将 脚本 改名 为 MyTrackable EventHandler.cs。 然 
后 双击 打开 ， 将 类 名 修改 为 MyTrackableEventHandler， 找 到 监听 识别 成 功 和 识别 丢失 的 两 个 方法 OnTrackingFound 和 OnTrackingLost， 黑 认 代码 如 下 : 


// 识 别 成 功 时 调用 的 方法 
private void OnTrackingFound() 


{ 


Renderer[] rendererComponents = GetComponentsInChildren«Renderer» (true); 
Collider[] colliderComponents = GetComponentsInChildren«Collider» (true); 
// Enable rendering: 

foreach (Renderer component in rendererComponents) 


{ 


component.enabled = true; 


} 
// Enable colliders: 
foreach (Collider component in colliderComponents) 


{ 


component.enabled = true; 


Debug. Log ("Trackable " + mTrackableBehaviour.TrackableName + " found"); 


} 

// 识 别 丢 失 时 调用 的 方法 

private void OnTrackingLost () { 
Renderer[] rendererComponents = GetComponentsInChildren«Renderer» (true); 
Collider[] colliderComponents = GetComponentsInChildren«Collider» (true); 
// Disable rendering: 

foreach (Renderer component in rendererComponents) 


{ 


` 


` 


component.enabled = false; 


// Disable colliders: 
foreach (Collider component in colliderComponents) 


I 
} 


Debug. Log ("Trackable " + mTrackableBehaviour.TrackableName + " lost"); 


component.enabled - false; 


EURAN AMA, OnTrackingFoundE ARERR А18, ОптТгаскіпоіоѕірА А9552 91098. ЈАН T EXTUS ВЕЕТ КАЈ Кепаегег В, 
通过 其 打开 或 关闭 来 实现 3D 物 体 的 显示 和 隐藏 。 现 在 我 们 通过 动态 加 载 的 方式 来 显示 3D 模 型 ， 需 要 删除 OnTrackingLost 和 OnTrackingFound 两 个 国 数 中 的 内 容 ， 并 将 代码 修改 为 动态 加 载 的 方式 实现 : 


// 识 别 成 功 时 调用 的 方法 
private void OnTrackingFound() 
{ 
// 动 态 加 载 模型 并 实例 化 到 场景 中 
GameObject obj = GameObject.Instantiate (Resources.Load("Sphere")) as GameObject; 
// 生 成 之 后 设 定 它 的 父 级 为 识别 图 物体 
obj.transform.parent = this.transform; 
// 设 定 物体 与 识别 图 在 同一 位 置 ， 这 里 可 以 根据 需求 设 定 


obj.transform.position = this.transform.position; 


} 
// 识 别 丢 失 时 调用 的 方法 
private void OnTrackingLost () 


{ 


// 从 子 物 体 中 查找 所 有 Trackobject 组 件 

TrackObject to-GetComponentInChildren«TrackObject»(); 
// 如 果 找 到 显示 物体 ， 则 销毁 物体 并 释放 无 用 资源 

if (to != null) 


{ 


Destroy (to.gameObject) ; 
Resources.UnloadUnusedAssets (); 


3. 效 果实 现 


选择 ImageTarget， 在 Inspector 面 板 上 选择 Remove Component， 并 将 DefaultTrackable EventHandler 脚 本 移 除 ， 同 时 把 MyTrackableEventHandler 脚 本 添加 到 ImageTarget 上 。 
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最 后 ， 点 击 运 行 以 测试 最 终 效果 ， 如 下 图 所 示 。 
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以 上 为 动态 加 载 AR 中 3D 物 体 的 步骤 和 方法 。 
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在 第 2 章 中 我 们 实现 了 通过 Vufoira 默 认 方 式 识别 并 显示 三 维 模型 。 默 认 的 加 载 模型 是 通过 将 3D 物 体 直 接 放置 在 场景 中 并 作为 识别 目标 的 子 物体 来 实现 的 ， 这 种 实现 方式 的 问题 是 ， 当 场景 中 有 很 多 识别 
目标 后 ， 需 要 一 次 性 加 载 的 模型 内 容 会 占用 很 大 的 内 存 。 因 此 ， 在 实际 项 目 案例 中 需要 动态 加 载 识 别 目标 对 应 的 模型 ， 在 识别 丢失 之 后 删除 模型 ， 这 样 可 以 保证 同一 时 刻 内 存 的 占用 是 手机 可 以 承受 的 。 


本 节 将 通过 预制 件 实例 化 的 方式 实现 AR 模型 的 动态 加 载 和 显示 。 
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将 ImageTarget 下 调整 好 的 模型 拖 到 最 上 层 ， 和 ImageTarget 在 层级 视图 中 保持 平 级 关系 。 
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在 Assets 目 录 中 创建 Resources 文 件 夹 ， 并 将 层级 视图 Hierarchy 中 的 模型 Sphere 拖 至 Resources 文 件 夹 中 ， 然 后 删除 层级 视图 Hierarchy 中 的 Sphere 模型 。 
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在 工程 视图 Project 中 创建 一 个 新 的 C# 脚 本 ， 命 名 为 TrackObject.cs， 该 脚本 是 为 了 更 方便 地 找到 识别 后 显示 的 物体 ， 将 其 拖 到 需要 加 载 的 预制 件 上 。 


在 工程 视图 Project 中 找到 DefaultTrackableEventHandler.cs 这 个 脚本 ， 按 住 Ctrl+ D 可 以 复制 一 份 相同 的 脚本 ， 选 中 新 复制 出 来 的 脚本 并 按 F2 快 捷 键 将 脚本 改名 为 MyTrackable EventHandler.cs, #& 
后 双击 打开 ， 将 类 名 修改 为 MyTrackableEventHandler， 找 到 监听 识别 成 功 和 识别 丢失 的 两 个 方法 OnTrackingFound 和 OnTrackingLost， 默 认 代码 如 下 : 


// 识 别 成 功 时 调用 的 方法 
private void OnTrackingFound() 


{ 


Renderer[] rendererComponents 
Collider[] colliderComponents 
// Enable rendering: 

foreach (Renderer component in rendererComponents) 


GetComponentsInChildren«Renderer» (true); 
GetComponentsInChildren«Collider» (true); 


component.enabled - true; 
} 
// Enable colliders: 
foreach (Collider component in colliderComponents) 


component.enabled - true; 
} 


Debug. Log ("Trackable " + mTrackableBehaviour.TrackableName + " found"); 


} 

// 识 别 丢失 时 调用 的 方法 

private void OnTrackingLost () { 
Renderer[] rendererComponents 
Collider[] colliderComponents 
// Disable rendering: 
foreach (Renderer component in rendererComponents) 


{ 


GetComponentsInChildren«Renderer» (true); 
GetComponentsInChildren«Collider» (true); 


component.enabled = false; 


} 
// Disable colliders: 
foreach (Collider component in colliderComponents) 


I 
} 


Debug. Log ("Trackable " + mTrackableBehaviour.TrackableName + " lost"); 


component.enabled - false; 


在 默认 的 这 两 个 方法 实现 中 ，OnTrackingFound 遂 数 在 识别 图 像 成 功 之 后 被 调用 ，OnTrackingLost 函 数 在 识别 丢失 之 后 被 调用 。 该 脚本 利用 了 查找 当前 识别 目标 所 有 子 物体 的 泻 染 器 Renderer 组 件 ， 
通过 其 打开 或 关闭 来 实现 3D 物 体 的 显示 和 隐藏 。 现 在 我 们 通过 动态 加 载 的 方式 来 显示 3D 模 型 ， 需 要 删除 OnTrackingLost 和 OnTrackingFound 两 个 遂 数 中 的 内 容 ， 并 将 代码 修改 为 动态 加 载 的 方式 实现 : 


// 识 别 成 功 时 调用 的 方法 
private void OnTrackingFound() 
{ 
// 动 态 加 载 模型 并 实例 化 到 场景 中 
GameObject obj = GameObject.Instantiate (Resources.Load("Sphere")) as GameObject; 
// 生 成 之 后 设 定 它 的 父 级 为 识别 图 物体 
obj.transform.parent = this.transform; 
// 设 定 物体 与 识别 图 在 同一 位 置 ， 这 里 可 以 根据 需求 设 定 


obj.transform.position = this.transform.position; 


} 
// 识 别 丢 失 时 调用 的 方法 
private void OnTrackingLost () 


{ 


// 从 子 物 体 中 查找 所 有 TrackobJject 组 件 

TrackObject to-GetComponentInChildren«TrackObject» (); 
// 如 果 找到 显示 物体 ， 则 销毁 物体 并 释放 无 用 资源 

if (to != null) 


{ 


Destroy (to.gameObject) ; 
Resources.UnloadUnusedAssets (); 


3. 效 果实 现 
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最 后 ， 点 击 运 行 以 测试 最 终 效果 ， 如 下 图 所 示 。 
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在 常见 的 AR 项 目 中 ， 识 别 到 图 像 后 会 将 3D 物 体 革 加 到 识别 目标 之 上 并 具有 追踪 效果 ， 但 是 当 识 别 目标 丢失 后 ,我们 希望 能 够 将 3D 模 型 停留 在 屏幕 中 心 ， 并 能 够 和 用 户 进行 交互 ， 比 如 点 击 模型 伴随 动 
画 切换 、 播 放 语 音 讲 解 等 一 系列 功能 。 这 个 功能 就 是 我 们 本 节 将 要 为 大 家 介绍 的 脱 卡 功能 。 


脱 卡 实现 的 原理 是 ， 将 3D 物 体 从 识别 目标 下 移出 ， 不 再 将 识别 图 作为 3D 物 体 的 父 对 象 ， 这 样 就 能 够 实现 模型 不 跟随 识别 物体 的 效果 。 接 下 来 我 们 将 模型 用 一 个 新 建 的 Camera 来 泻 染 ， 也 就 是 脱离 识别 
图 之 后 的 物体 是 完全 在 另外 一 个 Camera 坐 标 系 下 的 。 


其 实 ， 脱 卡 功能 还 有 更 简单 的 实现 方式 ， 比 如 在 ARCamera 下 创建 空 物体 作为 脱离 之 后 模型 的 目标 位 置 ， 然 后 在 脱离 识别 图 后 将 模型 移动 到 空 物体 下 。 


在 本 节 中 ， 我 们 使 用 另外 一 种 思路 来 实现 脱 卡 功能 。 


新 建 Unity 工 程 ， 分 别 导 入 Vuforia SDK 插 件 包 和 识别 图 数据 包 ， 然 后 根据 第 1 章 中 的 设置 方法 ， 将 需要 添加 的 物体 添加 到 场景 ， 并 调整 参数 以 正常 识别 并 显示 3D 物 体 。 
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选择 ImageTarget， 将 其 自身 的 DefaultTrackableEventHandler 移 除 ， 并 将 该 脚本 复制 一 份 命名 为 MyTrackableEventHandler， 然 后 附加 到 ImageTarget 上 。 然 后 创建 TrackObject.cs 和 Rotate.cs 两 
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双击 打开 Rotate.cs 文 件 ， 并 在 该 脚本 Update( 方 法 中 添加 一 行 代码 以 使 物体 旋转 ， 代 码 如 下 : 
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//Rotate.cs 
// 刷 新 函数 ， 每 一 帧 被 调用 一 次 
void Update () 


// 让 物体 绕 Y 轴 自转 


transform.Rotate (new Vector3(0f,1f,0f)); 


} 

/ /'TrackObject.cs 

//TrackObject 类 用 来 查找 和 确定 识别 后 显示 的 物体 
public class TrackObject : MonoBehaviour 


// 脱 卡 之 后 模型 的 位 置 
public Vector3 LostPosition; 


修改 MyTrackableEventHandler.cs 中 的 OnTrackingFound 和 OnTrackingLost 两 个 方法 。 


// 识 别 成 功 时 调用 的 方法 
private void OnTrackingFound () 
{ 
// 获 取 所 有 TrackObJject 物 体 并 将 它们 都 销毁 
TrackObject[] objects = FindObjectsOfType«TrackObject» (); 
foreach (TrackObject to in objects) 
{ 


Destroy (to.gameObject) ; 


) 

// 印 载 无 用 资源 
Resources.UnloadUnusedAssets (); 
// 加 载 需要 显示 的 模型 并 实例 化 到 场景 中 


GameObject орј= GameObject.Instantiate (Resources.Load(objectName))as GameObject; 


// 将 父 物体 设置 为 InageTarget 
obj.transform.parent = this.transform; 
// 设 置物 体位 置 


obj.transform.position = this.transform.position; 


} 
// 识 别 目 标 丢失 时 调用 
private void OnTrackingLost () 


{ 


// 从 子 物 体 中 获取 所 有 Trackobject 组 件 
TrackObject to = GetComponentInChildren«TrackObject»(); 
if (to != null) 


// 将 3D 物 体 的 父 对 象 从 识别 目标 下 移出 
to.transform.parent = this.transform.parent; 

// 设 置物 体 的 1ayer 值 ， 这 里 用 另 一 个 Camera 来 泻 染 脱 卡 之 后 的 模型 
to.gameObject.layer = 10; 

// 将 物体 的 位 置 设置 为 TrackObject 脚 本 中 设置 好 的 位 置 


to.transform.position = to.LostPosition; 


选择 ImageTarget， 在 Inspector 面 板 中 找到 MyTrackableEventHandler 脚 本 ， 设 定 以 下 参数 。 
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然后 将 Cube 拖 到 与 ImageTarget 平 级 的 层级 ， 如 下 图 所 示 。 
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接 下 来 在 Hierarchy 面 板 中 右 击 创建 一 个 新 的 Camera， 选 择 其 Inspector 面 板 Layer 标 签 中 的 Add Layer 命 令 创建 一 个 新 的 层 。 
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在 Layer 10 的 位 置 创建 一 个 新 的 图 层 Onshow。 再 调整 刚才 新 建 的 Camera 的 Clear Flags 属 性 如 下 。 


选择 Depth only， 然 后 在 Culling Mask 下 选择 OnShow 层 ， 如 下 图 所 示 。 
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4. 效 果实 现 
在 Assets 文 件 夹 中 新 建 一 个 名 为 Resources 的 文件 夹 ， 将 Cube 拖 到 该 文件 夹 中 生成 prefab 预 制 件 ， 并 删除 在 层级 视图 Hierarchy 中 的 Cube 物 体 。 


选中 ARCamera 子 物体 下 的 Camera 对 象 ， 在 其 Inspector 面 板 中 找到 Culling Mask 属 性 并 取消 勾 选 OnShow。 
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接 下 来 ， 点 击 运 行 便 可 测试 脱 卡 效果 的 实现 。 


目前 市 场 上 流行 的 AR 产品 以 儿童 教育 类 产品 居多 ， 这 些 产 品 中 大 多 会 有 手势 交互 的 功能 ， 本 节 就 将 讲解 如 何在 AR 产品 中 加 入 手势 交互 的 功能 。 设 想 以 下 场景 ， 在 识别 一 个 动物 的 卡片 后 ， 会 出 现 该 动物 
的 3D 立 体 影像 ， 在 识别 丢失 后 ， 动 物 模型 会 停留 在 屏幕 中 心 ， 并 可 以 通过 手势 控制 其 旋转 和 缩放 。 


我 们 需要 实现 模型 脱 卡 的 功能 ， 这 个 功能 的 实现 已 经 在 上 一 节 做 了 详细 讲解 ， 本 节 不 再 袭 述 。 


关于 手势 控制 ， 最 原始 的 方式 是 通过 Unity 3D 自 带 的 Input 类 进行 处 理 ， 但 是 为 了 快速 实现 我 们 想 要 达到 的 效果 ， 可 以 借助 一 些 插 件 来 实现 。 用 于 手势 处 理 的 插件 有 Finger Gesture、LeanTouch 和 
EasyTouch 等 ， 本 节 主 要 通过 EasyTouch 这 个 插件 来 讲解 手势 控制 功能 (本 节 使 用 的 插件 版 本 为 EasyTouch 5) 。 


接 下 来 ， 我 们 就 逐步 讲解 EasyTouch 的 使 用 方法 。 


正确 导入 EasyTouch 插 件 之 后 ， 在 Project 视 图 中 找到 QuickGesture 案 例 场 景 ， 这 个 场景 中 展示 了 插件 中 大 部 分 手势 的 案例 ， 该 场景 打开 后 的 界面 如 下 图 所 示 。 
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上 图 中 的 场景 展示 了 下 列 手 势 : 
` Touch: 触摸 手势 。 

“Тар: Ad. 

` Long tap: 长 按 手势 。 

: Drag: 拖 动 手势 。 

: Enter Over Exit: Fi FY. 
: Double tap: 双击 手势 。 

' Swipe: 滑动 手势 。 

C Twist: 扭转 手势 。 


| Pinch: 两 个 或 多 个 手指 挤 压 ， 常 用 于 缩放 。 


EasyTouch 初 始 化 的 方式 非常 简单 ， 只 需 在 场景 中 创建 一 个 空 的 GameObject， 将 其 命名 为 EasyTouch， 然 后 在 Inspector 面 板 上 点 击 AddComponent 添 加 EasyTouch.cs 脚 本 文件 即 可 。 


初始 化 模型 的 工作 完成 之 后 ， 接 下 来 演示 旋转 模型 的 实现 方式 。 查 看 之 前 案例 场景 中 Horizontal Swipe 下 的 物体 ， 你 会 发 现 当 鼠 标 在 该 物体 上 左右 滑动 时 ， 就 可 以 让 物体 发 生 水 平方 向 的 旋转 ， 我 们 查 
看 被 旋转 物体 上 的 组 件 信息 ， 发 现 该 物体 拥有 一 个 名 为 QuickSwipe 的 组 件 。 


因此 ， 只 要 给 需要 旋转 的 物体 添加 QuickSwipe 组 件 ， 即 可 让 物体 根据 手势 滑动 的 方向 进行 旋转 。Quick Swipe 组 件 的 参数 如 下 图 所 示 。 
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上 图 中 的 Swipe direction 选 项 表示 判断 手势 滑动 的 方向 ,例如 Horizontal 表 示 水 平方 向 ，Vertical 表 示 竖 直方 向 。Action 中 的 选项 表示 当 手 势 触 发 之 后 ， 所 影响 的 物体 会 发 生 哪 些 类 型 的 动作 ， 可 以 选 
择 的 动作 有 Rotate (旋转 ) 、Translate (移动 ) 和 Scale (缩放 ) ， 在 此 我 们 选择 Rotate 选 项 即 可 。Affected axes 表 示 被 影响 的 坐标 轴 ， 如 果 是 水 平方 向 泻 染 ， 则 选择 Y 轴 。Sensibility 表 示 灵 敏 度 ， 可 以 
根据 灵敏 度 调 整 旋转 的 速度 ，Inverse axis 表 示 反 向 。 


4 缩放 模型 


在 手机 App 中 ， 一 般 是 通过 两 个 手指 在 触摸 屏幕 上 的 距离 远近 变化 来 控制 模型 的 大 小 ， 因 此 我 们 采用 EasyTouch 中 的 另外 一 种 Pinch 事 件 。 在 上 述 案例 场景 中 我 们 可 以 看 到 这 个 事件 ， 但 是 在 Unity 编 辑 
器 中 无 法 通过 鼠标 模拟 多 点 触 控 ，EasyTouch 的 解决 方案 是 : 首先 用 Ctrl+ 鼠 标 左 键 确定 第 一 个 手指 的 位 置 ， 然 后 通过 Alt+ 鼠 标 左 键 来 控制 第 二 个 手指 的 位 置 与 第 一 个 手指 的 位 置 之 间 的 距离 。 
(1) Ctrl+ 鼠标 左 键 确定 第 一 个 手指 的 位 置 。 


(2) Alt+ 鼠 标 左 键 滑动 控制 模型 缩放 。 


通过 Alt+ 鼠标 左 键 
滑动 ， 模 型 被 放大 


SN 


通过 Ctrl+ 鼠标 左 键 确定 
第 一 个 手指 的 坐标 $ 
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在 实现 缩放 控制 的 时 候 ，EasyTouch 为 我 们 提供 的 接口 也 特别 简单 。 与 旋转 模型 类 似 ， 只 需要 给 被 旋转 的 物体 加 上 一 个 QuickPinch 组 件 ， 但 是 不 要 忘记 给 物体 再 添加 一 个 碰撞 器 组 件 。 
5. 拖 动 模型 

拖 动 模型 是 指 ， 当 鼠标 或 手指 选择 屏幕 中 的 某 个 物体 之 后 ， 拖 动手 指 ， 物 体会 跟随 手指 进行 移动 ， 如 果 不 借助 插件 ， 则 实现 步骤 如 下 。 

(1) 通过 Unity 中 的 Input 类 获取 当前 鼠标 的 位 置 或 触摸 点 的 位 置 ， 返 回 的 坐标 信息 为 屏幕 坐标 。 

(2) 将 获取 的 屏幕 坐标 转换 为 世界 坐标 ， 这 个 步骤 可 以 通过 Camera 中 的 ScreenToWorldPoint 方 法 来 实现 。 

(3) 将 模型 的 位 置 移动 到 转换 后 的 世界 坐标 位 置 。 


上 述 实现 过 程 比 较 麻烦 ， 因 此 我 们 直接 采用 EasyTouch 中 的 QuickDrag 组 件 实现 。 我 们 只 需要 给 被 拖 动 的 物体 添加 QuickDrag 组 件 。 如 果 要 实现 两 个 手指 拖 动 ， 则 添加 TwoDragMe 这 个 脚本 组 件 就 可 
以 了 。 


本 节 关 于 手势 控制 的 内 容 已 经 介绍 完毕 ， 其 实 EasyTouch 还 拥有 其 他 一 些 手势 控制 和 功能 ， 大 家 可 以 参考 它 的 帮助 文档 。 


第 4 章 AR 互动 大 屏 : 透明 视频 的 实现 
互动 大 屏 是 AR 中 常见 的 应 用 方式 ， 在 互动 大 屏 的 开发 过 程 中 ， 常 常会 用 到 透明 视频 的 播放 。 比 如 ， 在 商场 中 放置 一 块 大 屏幕 ， 平 时 看 上 去 像 - 面 镜子 ， 实 际 上 屏幕 背后 的 主机 连接 了 摄像 头 ， 屏 幕 上 显 


示 的 只 是 摄像 头 拍摄 到 的 画面 ， 当 人 靠近 屏幕 或 者 摄像 头 捕捉 到 人 的 图 像 或 动作 时 ， 就 会 生成 虚拟 的 人 物 ， 如 美女 明星 。 对 于 观众 来 说 ， 当 他 看 向 屏幕 的 时 候 ， 会 以 为 美女 明星 真 的 出 现在 自己 身 旁 ， 但 实 
际 上 这 只 是 一 个 美丽 的 错觉 而 已 。 本 章 主要 介绍 如 何在 Unity 中 实现 透明 视频 的 播放 ， 这 部 分 内 容 包括 视频 的 制作 、 特 殊 Shader 的 编写 、 在 Unity 中 不 借助 AR SDK 打 开 摄 像 头 以 及 视频 的 播放 方法 。 


44 使 用 AE 制 作 带 Alpha 通 道 的 视频 


为 了 更 好 地 实现 透明 视频 的 播放 ， 我 们 将 视频 分 为 左右 两 部 分 ， 左 边 为 正常 的 视频 ， 右 边 只 有 该 视频 的 黑白 剪影 。 通 过 Shader 获 取 右 边 位 置 的 颜色 信息 ， 如 果 右 边 对 应 坐标 的 颜色 值 为 黑色 ， 则 左边 视 
频 相应 位 置 的 Alpha 值 为 0 (透明 ) ， 否 则 保留 原本 的 透明 度 即 可 。 借 助 下 面 的 图 像 会 更 容易 理解 这 一 原理 。 


上 图 中 左边 的 视频 会 根据 右边 的 剪影 进行 透明 度 的 设置 ， 最 终 显示 的 视频 内 容 只 有 左边 的 蝴蝶 图 案 。 


接 下 来 我 们 介绍 如 何 用 AE (Adobe After Effects) 软件 来 处 理 视频 。 
(1) 准备 需要 进行 通道 处 理 的 视频 素材 ， 本 节 使 用 视频 素材 名 为 “飞舞 的 蝴蝶 ”。 
(2) 打开 AE， 选 择 File_import file (快捷 键 Ctrl+1) 找到 相应 的 素材 文件 ， 点 击 打开 。 


(3) 新 建 合 成 (Ctrl+N) ， 命 名 为 “飞舞 的 蝴蝶 ”， 太 十 改 为 240pxx320px， 素 材 时 长 126 帧 〈 可 以 查看 素材 的 时 间 长 度 ) ， 点 击 OK 按钮 。 


| Composition Settings 


Preset: Custom 


Width: 240 px 
Lock Aspect Ratio to 3:4 (0.75) 
Height: 320 px 


Pixel Aspect Ratio: Square Pixels Frame Aspect Ratio: 
3:4 (0.75) 


Frame Kate: v frames per second Drop Frame 


Resolution: Full 240 x 320, 300 KB per Wbpe frame 
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Background Color: z Black 


W Preview | Cancel 


(4) 将 素材 拖 进 合成 里 面 ， 按 S 键 进行 素材 大 小 的 调整 ， 让 画面 居中 显示 ， 并 且 保 证 画面 不 会 被 裁 切 掉 。 

(5) 复制 (Ctrl+D) “飞舞 的 蝴蝶 ”合成 ， 命 名 为 “飞舞 的 蝴蝶 Alpha”。 

(6) 在 合成 中 右键 创建 一 个 白色 的 固态 层 (Ctrl+Y) ， 此 层 必须 在 素材 的 下 面 ， 并 选择 Alpha 模 式 为 Alpha Matte "КИ" гоу, 
(7) 新 建 合成 ， 大 小 为 480pxx320px， 目 的 是 将 视频 宽度 放大 为 原 视 频 的 两 倍 。 


(8) 将 之 前 的 “飞舞 的 蝴蝶 ”合成 放 入 到 新 “合成 ”中 ， 按 P 键 移动 为 240 的 一 半 (120). 
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(9) 将 之 前 的 “飞舞 的 蝴蝶 Alpha” 合 成 放 入 新 “合成 ”中 ， 按 P 键 移动 为 360。 
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(10) 选择 合成 (Ctrl- M) 输出 一 个 .mp4 格 式 的 文件 。 
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以 上 步骤 可 将 一 个 普通 视频 处 理 成 在 程序 中 用 Shader 进 行 透明 处 理 的 视频 ， 下 一 节 我 们 将 介绍 如 何 通 过 Unity 中 的 Shader 显 示 不 透明 区 域 的 视频 画面 。 


本 节 的 主要 内 容 是 编写 一 个 着 色 器 (Shader) ， 用 于 将 上 一 节 中 的 视频 按照 我 们 需要 的 方式 进行 透明 度 (Alpha) 处 理 。 


新 建 C# 脚 本 ， 命 名 为 PlayM ovie 并 写 入 如 下 代码 : 


// 声 明 一 个 公共 的 MovieTexture 交 量 testmovie, 这 是 一 个 .ovg 格 式 的 影片 
public MovieTexture testmovie; 
void Start () 
{ 
// 这 行 代 码 是 用 来 测试 的 ， 之 后 需要 将 其 删 掉 
testmovie.Play(); 
// 设 置 影片 是 可 以 循环 的 ， 如 果 不 想 循环 ， 则 设置 为 false 
testmovie.loop = true; 


在 场景 中 新 建 一 个 面 片 (Plane) ， 更 名 为 movie， 将 PlayMovie 脚 本 拖 上 去 ， 同 时 在 MovieTextrue 处 将 视频 素材 拖 上 去 。 
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接 下 来 创建 一 个 Shader， 命 名 为 movieshader。 
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Refresh Render Texture 


Project 
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Reimport All Animator Controller 
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将 Shader 中 原来 的 代码 都 删除 ， 然 后 再 写 入 如 下 代码 。 


Shader "Custom/shaderMovie" 


{ 


Properties 


// 声 明 一 个 2D 贴 图 ， 默 认 的 颜色 为 黑色 MainTex("Color (RGB)", 2D) = "black" 


} 
//SubShader， 泻 染 方 案 。 每 个 可 编程 Shader 中 至 少 有 一 个 SubShaqer， 可 为 不 同 显卡 编写 不 同 SupShader 
SubShader( 
// 子 着 色 器 使 用 标签 (Tags) 来 告诉 泻 染 引擎 何 时 和 如 何 泻 染 对 象 
/ /Tags { 1" = "#1" 2" = "ñ 2" ) 
// 标 签 是 标准 的 键 值 对 ， 可 以 有 任意 多 个 ， 常 用 的 标签 如 下 
// Queue 一 一 队列 标签 ， 用 来 决定 对 象 被 泻 染 的 次 序 
// 着 色 器 决定 对 象 所 归属 的 泻 染 队列 ， 任 何 透 明 物 体 都 可 以 通过 这 种 方法 确保 在 不 透明 物体 泻 染 之 后 泻 染 
//ShaderLab 中 有 4 种 预定 义 的 演 染 队列 
//Background 一 一 后 台 ， 这 个 演 数 队列 在 所 有 队列 之 前 被 演 染 ， 用 于 演 娄 天 空 例 之 类 的 对 象 
//Geometry 一 一 几何 体 ， 这 个 队列 是 默认 队列 ， 用 于 大 多 数 对 象 。 不 透明 的 几何 体 使 用 这 个 队列 
//Transparent 一 一 黎明 ， 这 个 演 染 队列 在 几何 体 队列 之 后 被 泻 染 ， 采 用 由 后 到 前 的 次 序 。 任 何 采 用 Alpha 混 合 的 对 象 (不 对 深度 缓冲 产生 写 操作 的 着 色 器 ) 都 应 该 在 这 里 泻 染 (如 玻璃 、 粒 子 效果 ) 
//Overlay 一 一 被 盖 ， 这 个 演 染 队列 用 于 实现 登 加 效果 。 任 何 需要 最 后 演 染 的 对 象 都 应 该 放置 在 此 处 (如 镜头 光 尝 ) 
Tags{ "Queue" = "Transparent" "RenderType" = "Transparent" } 
//CG 代 码 必 须 用 
/ /CGPROGRAM 
/ /http: / /www .hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15940/OEBPS/Text/... 
/ /ENDCG4£2 Ж 
//pragma surface 是 定义 unity Surface Shader h x 1 
CGPROGRAM 
fpragma surface surf NoLighting alpha 
//Alpha 的 数值 决定 了 一 张贴 图 的 透明 度 
fixed4 LightingNoLighting(SurfaceOutput s, fixed3 lightDir, fixed atten) { 
Ғіхеа4 c; 
c.rgb = s.Albedo; 
c.a = s.Alpha; 
return c; 


I 


) 
// 声 明了 一 个 Input 的 结构 体 
struct Input 


{ 
Lr 


sampler2D  MainTex; 
void surf(Input IN, inout SurfaceOutput o) 


{ 


float2 uv MainTex; 


o.Emission = tex2D( MainTex, IN.uv MainTex).rgb; 

// 将 黑白 中 的 一 部 分 ALPha 值 设 为 0 
// 这 个 阅 值 及 大 于 、 小 于 号 需要 根据 具体 的 电影 文件 来 设置 ， 一 般 在 0.45~0.5 之 间 
if(IN.uv MainTex.x >= 0.5) 


{ 


о.А1рһа=0; 


} 
// 将 另 一 半 画 面 的 ALPha 值 设置 为 黑白 部 分 的 RGB 值 
else 


o.Alpha = tex2D( MainTex, float2(IN.uv MainTex.x*0.5, IN.uv MainTex.y)).rgb; 


) 
ENDCG 


显示 屏 从 左 到 右 依 次 是 数字 0 和 1， 上 述 代码 将 画面 分 割 为 两 半 ， 然 后 再 改变 各 自 的 透明 通道 (Alpha) 的 值 。 


接 下 来 创建 一 个 材质 球 ， 命 名 为 movie， 将 shadermovie 赋 给 材质 球 movie， 然 后 把 材质 球 抑 给 面 片 Plane， 效 果 如 下 。 
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材质 球 ， 然 后 调整 到 合适 属性 ， 出 现 如 下 效果 。 
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如 果 视 频 有 声音 ， 就 为 它 添加 AudioSsource 的 组 件 ， 并 把 .ogv 格 式 下 的 audio 文 件 拖 至 AudioClip。 
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最 后 ， 点 击 运 行 以 测试 效果 ， 可 以 看 到 最 终 游戏 界面 上 显示 的 图 像 只 有 蝴蝶 的 图 案 ， 达 到 了 我 们 预期 的 透明 效果 ， 如 下 图 所 示 。 


43 ”开启 摄像 头 并 实现 互动 大 屏 的 视频 播放 


首先 需要 开启 摄像 头 ， 如 果 我 们 采用 Vuforia SDK 中 的 ARCamera 实 现 开启 摄像 头 ， 会 发 现 早 期 的 Vuforia SDK 是 不 支持 导出 到 PC 平台 的 ， 因 此 可 以 直接 在 Unity 中 开启 摄像 头 。 具 体 的 实现 步骤 如 下 。 


新 建 一 个 脚本 OutCamera， 代 码 如 下 : 


using UnityEngine; 

using System.Collections; 
using System.Threading; 
using UnityEngine.UI; 
public class OutCamera : MonoBehaviour 


{ 


public RawlImage image; 
public WebCamTexture webTex; 
public string deviceName; 
void Start () 


// 调 用 启动 的 协 程 ， 开 启 摄 像 头 


StartCoroutine ("CallCamera"); 


} 
private void Update () 


{ 


if (webTex != null) 
{ 
} 


image.texture = webTex; 


} 
private IEnumerator CallCamera () 


{ 


yield return Application.RequestUserAuthorization (UserAuthorization.WebCam) ; 


if (Application.HasUserAuthorization (UserAuthorization.WebCam)) 


{ 


WebCamDevice[] devices = WebCamTexture.devices; 

deviceName = devices[0].name; 

// 设 置 摄像 机 摄像 的 区 域 

webTex = new WebCamTexture (deviceName,Screen.width,Screen.height,20); 
// 如 果 需 要 导出 到 移动 设备 上 ， 需 要 使 用 下 面 的 代码 

//webTex = new WebCamTexture (deviceName, 800, 600, 20); 

/ /开始 摄像 

webTex. Play (); 


创建 一 个 Rawlmage 以 及 Play、Pause、Stop 三 个 按钮 ， 将 Rawlmage 调 整 为 全 屏 显 示 ， 并 将 三 个 按钮 的 位 置 调 整 好 ， 如 下 图 所 示 。 


将 OutCamera 脚 本 拖 给 一 个 空 物 体 ， 将 Rawlmage 赋 给 image 变量 ， 其 他 两 个 变量 不 用 赋值 ， 在 运行 的 时 候 ， 脚 本 会 自动 调用 外 部 摄像 机 。 


ScriptSaameOb]ject 


将 Canvas 的 Render Mode 属 性 设置 为 Screen Space-Camera， 并 且 将 Render Camera 设 置 为 Main Camera, 


将 Main Camera 的 投影 方式 (Projection) 设置 为 正 交 投影 (Orthographic) 。 然 后 调整 之 前 做 好 的 movie 以 使 其 处 于 合适 的 位 置 。 


打开 之 前 的 PlayM ovie 脚 本 ， 改 变 其 中 的 代码 如 下 : 


using UnityEngine; 


using Syst 


tem.Collections; 


public class PlayMovie : MonoBehaviour 


{ 


脚本 添加 完成 之 后 ， 接 下 来 为 每 个 按钮 指定 点 击 事件 ， 让 每 个 按钮 点 击 时 调用 正确 的 方法 。 完 成 之 后 ， 运 行 测试 。 


既 可 以 看 到 真实 的 世界 ， 又 可 以 看 到 虚拟 的 影像 ， 这 样 就 实现 了 大 屏 互动 ! 


public MovieTexture testmovie; 
void Start () 


I 
} 


testm 


/// «summary» 
/// Play 按钮 点 击 事件 
/// </summary> 
public void OnPlayButtonClick() 


ovie.loop = true; 


I 
} 


testm 


/// «summary» 
/// Pause 按 钮 点 击 事件 
/// </summary> 
public void OnPauseButtonClick () 


{ 


} 
/// «summ 


testm 


ary» 


ovie.Play(); 


ovie.Pause(); 


/// Stop 按 钮 点 击 事件 


/// «/sum 


mary» 


public void OnS! 


{ 


testm 


} 


copButtonClick() 


ovie. Sst 


сор (); 


$8525 ARH EI: AR 与 Flash 动 画 的 结合 


本 章 的 主要 内 容 是 将 Flash 动 画 导 入 Unity， 实 现 AR 动画 的 效果 。Unity 3D 本 身 是 不 支持 播放 Flash 动 画 的 ， 所 幸 我 们 找到 了 一 款 插 件 ， 可 以 直接 将 Flash 动 画 导 出 并 在 Unity 环 境 下 播放 ， 这 个 插件 叫 
GAF Converter， 使 用 方便 简洁 ， 能 够 快速 实现 我 们 想 要 达到 的 效果 。 


5.1 ”准备 GAF 插 件 


登录 GAF 官 网 http://gafmedia.com/downloads， 分 别 下 载 电 脑 版 和 Unity 版 ， 本 章 下 载 的 版 本 为 5.4。 


GAF Converter з. | Tawa 
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下 载 好 之 后 将 得 弄 jgaf.unitypackage 和 GAF-Converter-5.4.exe 两 个 文件 ，exe 文 件 安装 完成 之 后 ， 能 够 将 swf 文 件 直 接 转 化 为 Unity 支 持 的 资源 ， 接 下 来 在 Unity 工 程 中 导入 gaf.unitypackage 揪 件 包 ， 
该 插件 包 中 包含 了 能 够 播放 Flash 资 源 的 代码 。 


5.2 ”实现 动画 播放 


本 章 采 用 GAF 自 带 的 案例 来 进行 讲解 ， 在 Assets 文 件 夹 的 GAF 文 件 夹 下 找到 Robot 资 源 文件 。 
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File Edit Assets 
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Z Hierarch 


选择 该 文件 ， 
Baked 表 示 不 创建 子 对 象 文件 ， 将 该 Flash 整 合 为 


Not baked 表 示 创 建 该 Flash 给 部 分 子 对 象 ， 形 成 可 拆 分 对 象 。 


GameObject Component GAF Window Hep 


在 Inspector 面 板 中 找到 上 图 所 示 位 置 。 


个 完整 的 个 体 。 
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三 个 按钮 的 意思 分 别 是 : A. 只 将 该 模型 生成 到 场景 中 ; B. 只 创建 为 预制 件 ; .在 创建 为 预制 件 的 同时 ， 在 场景 中 也 添加 一 个 。 


此 处 我 们 选择 只 在 场景 中 创建 一 个 整个 的 对 象 ， 所 以 选择 Baked 并 点 击 A 按 钮 。 这 样 一 个 Flash 文 件 在 Unity 场 景 中 就 创建 完成 了 。 


HARF = 
HARDIS FH 


这 里 我 们 使 用 Vuforia 提 供 的 SDK 以 及 数据 包 ， 分 别 导 入 相应 的 SDK 以 及 在 官网 加 载 好 的 数据 包 。 


将 生成 的 RedRobot 对 象 拖 到 ImageTarget 下 ， 成 为 其 子 对 象 ， 然 后 配置 AR 环境 ， 将 RedRobot 调 整 到 合适 的 属性 位 置 。 
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Ө setting 105 scripting backend to ILZCPP ti 
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Ignore time scale: 


在 最 新 的 Vuforia 版 本 中 ， 可 能 会 出 现 无 法 显示 的 错误 ， 这 时 候 需要 将 ARCamera/Camera/BackgroundPlane 物 体 的 材质 球 的 Shader 改 为 standard。 


接 下 来 点 击 运行 进行 效果 测试 ， 至 此 ， 在 Unity 中 导入 Flash 动 画 的 教程 就 结束 了 。 
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第 6 草 АРАҒА: 卡 牌 对 战 


本 章 将 讲解 AR 卡 牌 对 战 游戏 的 详细 制作 过 程 ， 共 分 为 两 节 ，6.1 节 讲解 Vuforia SDK 的 多 图 识别 生成 模型 的 功能 ， 在 此 基础 上 ，6.2 节 讲解 卡 牌 对 战功 能 的 实现 。 


61 多 图 识别 生成 模型 


本 书 第 2 章 的 前 两 节 讲 述 了 利用 Vuforia SDK 开 发 单 图 识别 的 AR 应 用 案例 ， 本 节 将 基于 前 面 的 这 部 分 内 容 讲述 利用 Vuforia SDK 开 发 多 图 识别 的 AR 应 用 。 开 始 本 节 内 容 前 需要 准备 以 下 内 容 : 
“ 两 张 识别 图 


: Vuforia SDK 


准备 好 以 上 内 容 后 ， 下 面 开 始 制作 。 


(1) 在 Vuforia 官 网 的 License Manager 下 创建 一 个 License Key。 本 节 创 建 了 一 个 名 为 MultiMap 的 License Key, 
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Create a license key for your application. 


Date Modified 


MuitiMap Aug 22, 2016 17:50 


(2) 在 Target Manager 下 创建 一 个 Database， 将 准备 好 的 两 张 识别 图 上 传 到 这 个 Database 下 ， 然 后 下 载 这 两 个 Targets。 本 节 创 建 的 Database 是 ARGame， 其 中 包含 两 个 Targets， 分 别 是 Enemy 


和 Tower。 
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Enemy 对 应 的 识别 图 是 : 


(3) 在 Unity 工 程 中 准备 好 Vuforia 开 发 环境 ， 导 入 下 载 好 的 两 个 Data 
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须 将 MaxSimultaneous Tracked Images 设 置 成 大 于 1 的 数字 (本 节 设 置 为 2) ， 
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这 是 单 图 识别 和 多 图 识别 设置 的 主要 区 别 。 


(4) 将 Vuforia 预 制 件 mageTarget 拖 入 Hierarchy 面 板 两 次 ， 分 别 设置 其 Database 为 Game11 和 Game12。 
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(5) 为 测试 识别 效果 ， 为 ImageTagert 添 加 一 个 立方 体 作为 子 物 体 ， 为 ImageTagert (1) 添加 一 个 球体 作为 子 物 体 ， 适 当 调 整 两 个 子 物 体 的 大 小 和 颜色 。 
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(6) 点 击 运行 ， 摄 像 头 扫描 两 张 识别 图 时 ， 同 时 出 现 Cube 和 Sphere， 如 下 图 。 
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6.2” 卡 牌 对 战功 能 的 实现 

基于 上 一 节 的 内 容 ， 本 节 开 始 介 绍 卡 牌 对 战功 能 的 实现 。 本 节 要 用 到 一 个 高 塔 模型 和 一 个 人 物 模型 ， 其 获取 方法 后 面 会 讲 。 对 战 过 程 中 ， 高 塔 向 人 物 发 射 炮弹 ， 人 物 可 用 手中 兵器 攻击 高 塔 ， 高 塔 和 人 
物 都 有 代表 其 生命 值 的 血 条 。 

首先 ， 我 们 来 分 析 一 下 功能 需 : 

. 可 以 进行 AR 多 卡 识别 。 

- 当 两 张 卡 的 距离 满足 一 定 条 件 时 ， 触 发 对 战事 件 。 

' 炮弹 要 能 追踪 到 人 物 ， 也 要 能 在 攻击 完成 后 实施 销毁 以 释放 内 存 资源 。 

当 两 个 游戏 对 象 距 离 较 远 时 ， 人 物 处 于 静止 状态 ， 但 距离 满足 条 件 后 处 于 行走 状态 ， 当 行走 到 可 攻击 塔 的 范围 内 时 切换 为 攻击 状态 。 

` 当 高 塔 受到 攻击 或 人 物 被 袭击 时 血 条 会 不 断 消 减 。 

` 当 高 塔 血 条 为 空 时 ， 颜 色 变 黑 ， 同 时 人 物 状 态 切 换 为 静止 。 

当 人 物 血 条 为 空 时 ， 人 物 消失 ， 同 时 高 塔 停止 发 射 子 弹 。 

接 下 来 ， 我 们 开始 详细 讲解 游戏 的 制作 过 程 。 


(1) 在 上 一 节制 作 的 基础 上 ， 保 证 网 络 连接 正常 ， 打 开 Unity 的 Asset store， 搜 索 Honeti， 在 搜索 框 下 的 MAXIMUM PRICE 栏 选择 FREE ONLY， 按 回 车 后 在 最 下 方 选 择 第 一 个 模型 ， 点 击 下 载 。 
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(2) 下 载 完成 后 选择 import 导 入 当前 工程 。 
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(3) 导入 后 的 Asset 面 板 下 多 了 一 个 Free Character 文 件 夹 ， 其 中 包含 三 个 人 物 模型 和 相应 的 动画 ， 本 节 将 使 用 其 中 一 个 人 物 模型 进行 讲解 。 
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(4) 按照 与 步骤 (1) 同样 的 方法 在 Asset Store 中 搜索 Canon Tower， 选 择 第 一 个 对 象 ， 下 载 并 导入 当前 工程 。 之 后 Project 面 板 的 Assets 下 便 多 了 一 个 CanonTower 文 件 夹 。 至 此 ， 我 们 获得 了 两 个 
游戏 对 象 : 高 塔 和 人 物 。 


(5) 在 Project 面 板 下 按 路 径 Assets 一 CanonTower 一 Prefabs 一 Tower 找 到 Tower 预 制 件 ， 将 其 拖 入 Hierarchy 面 板 ， 置 于 ImageTarget 中 心 处 并 调整 为 合适 的 大 小 。 在 Assets 面 板 中 新 建文 件 夹 ， 命 
名 为 Resources。 


(6) 按照 与 步骤 5 相同 的 方法 ， 在 Project 面 板 下 按 路 径 Assets 一 FreeCharactor 一 Prefabs 一 Lumberjack1 找 到 Lumberjack1 预 制 件 ， 将 其 拖 入 Hierarchy 面 板 ， 置 于 ImageTarget (1) 中 心 处 并 调整 
为 合适 的 大 小 。 将 其 改名 为 Enemy。 


(7) 在 Hierarchy 中 新 建 一 个 Sphere， 改 名 为 Bullet， 在 Project 面 板 的 Assets 下 新 建 一 个 Material， 将 其 颜色 调整 为 红色 后 赋 给 Bullet。 


(8) 在 Project 面 板 的 Assets 下 新 建 一 个 文件 夹 ， 命 名 为 Scripts， 用 以 存放 自己 写 的 脚本 。 在 Assets 面 板 下 搜索 DefaultTrackableEventHandler 脚 本 ， 按 Ctrl+ D 复 制 一 份 ， 将 复制 件 拖 动 到 Scripts 文 件 
夹 内 ， 改 名 为 MyTrackableEventHandler， 双 击 该 脚本 打开 编译 器 ， 同 样 将 类 名 改 为 MyTrackableEventHandler。 


& Project | ?三 1 /* 
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(9) 下 面 来 讲解 MyTrackableEventHandler 脚 本 的 框架 。 


ITrackableEventHandler 
1 
region PR IVAIE MEMBER VAR IABLES 


private TrackableBehavicur mTrackableBehaviour; 


fendregion // PRIVATE MEMBER VARIABLES 


using UnityEngine; 
namespace Vuforia 


{ 


public class MyTrackableEventHandler: MonoBehaviour, 
ITrackableEventHandler 
I 
#region PRIVATE MEMBER VARIABLES 
private TrackableBehaviour mTrackableBehaviour; 
*endregion // PRIVATE MEMBER VARIABLES 
#region UNTIY MONOBEHAVIOUR METHODS 
void Start () 

I 
mTrackableBehaviour = GetComponent<TrackableBehaviour>(); 
if (mTrackableBehaviour) 


mTrackableBehaviour.RegisterTrackableEventHandler (this); 
) 
} 
#endregion // UNTIY MONOBEHAVIOUR METHODS 
#region PUBLIC METHODS 3 
// 该 方法 的 功能 是 检测 摄像 头 追 踪 状 态 ， 检 测 到 识别 图 时 执行 
//OnTrackingFound(), ， 检 测 不 到 识别 图 时 执行 OnTrackingLost () 
public void OnTrackableStateChanged|( 
TrackableBehaviour.Status previousStatus, 
TrackableBehaviour.Status newStatus) 


if (newStatus == TrackableBehaviour.Status.DETECTED || 
newStatus == TrackableBehaviour.Status.TRACKED || 
newStatus == TrackableBehaviour.Status.EXTENDED TRACKED) 
{ 


OnTrackingFound(); 


} 


else 


{ 
} 


OnTrackingLost (); 


} 

#endregion // PUBLIC METHODS 
#region PRIVATE METHODS 
private void OnTrackingFound() 
Í 
) 
private void OnTrackingLost () 
{ 
} 
#endregion // PRIVATE METHODS 


(10) 现在 用 该 脚本 来 实现 成 功 扫 描 识 别 图 后 动态 加 载 游 戏 对 象 Tower1 (之 前 做 好 的 预制 体 ) 。 将 该 脚本 挂 载 到 ImageTarget 上 ， 在 Inspector 面 板 中 将 制作 好 的 预制 件 拖 动 到 TowerPrefab 属 性 上 ， 
移 除 脚本 DefaultTrackableEventHandler。 


using UnityEngine; 
namespace Vuforia 


{ 


public class MyTrackableEventHandler: MonoBehaviour, ITrackableEventHandler 

I 
public GameObject TowerPrefab; 
#region PRIVATE MEMBER VARIABLES 
private TrackableBehaviour mTrackableBehaviour; 
#endregion // PRIVATE MEMBER VARIABLES 
$region UNTIY MONOBEHAVIOUR METHODS 

void Start() ` Е 


{ 


mTrackableBehaviour = GetComponent«TrackableBehaviour» (); 
if (mIrackableBehaviour) 


I 
} 


mTrackableBehaviour.RegisterTrackableEventHandler (this); 


} 
fendregion // UNTIY MONOBEHAVIOUR METHODS 
#region PUBLIC METHODS Е 
public void OnTrackableStateChanged|( 
TrackableBehaviour.Status previousStatus, 
TrackableBehaviour.Status newStatus) 


if (newStatus == TrackableBehaviour.Status.DETECTED || 
newStatus == TrackableBehaviour.Status.TRACKED || 
newStatus == TrackableBehaviour.Status.EXTENDED TRACKED) 
{ 


OnTrackingFound(); 


} 


else 


{ 
} 


OnTrackingLost (); 


) 

#endregion // PUBLIC METHODS 
#region PRIVATE METHODS 
private void OnTrackingFound() 


Í 


GameObject Tower = GameObject.Instantiate (TowerPrefab ) as GameObject; 
Tower.transform .parent = this.transform; 

Tower.transform.position = this.transform.position; 
Debug.Log("Trackable " + mTrackableBehaviour.TrackableName + " found"); 


) 
private void OnTrackingLost () 
{ 
TowerController tower = GetComponentInChildren«TowerController»(); 
if (tower != null) í 
DestroyImmediate (tower.gameCbject); 


r 


— 


} 


Debug. Log ("Trackable " + mTrackableBehaviour.TrackableName + " lost"); 


} 
#endregion // PRIVATE METHODS 


(11) 在 Assets 一 Scripts 文 件 夹 下 新 建 三 个 脚本 ， 分 别 取 名 为 EnemyController、Tower Controller 和 Bullet， 将 这 三 个 脚本 分 别 挂 载 在 Hierarchy 面 板 中 的 Enemy、Tower 和 Bullet 三 个 游戏 对 象 上 ， 
接 下 来 就 要 分 别 编辑 这 三 个 游戏 对 象 及 其 脚本 以 实现 对 三 个 游戏 对 象 的 控制 。 


(12) 首先 来 实现 Enemy 的 静止 、 行 走 和 攻击 三 个 动作 状态 逻辑 。 在 Hierarchy 面 板 中 选中 Enemy 游 戏 对 象 ， 在 Inspector 面 板 中 移 除 Animation 组 件 ， 勾 选 Animator 组 件 ， 如 下 图 所 示 。 
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(13) 在 Project 面 板 的 Assets 下 单 击 右键 ， 新 建 一 个 AnimatorController， 改 名 为 EnemyAnimator， 在 Hierarchy 面 板 选中 Enemy， 将 新 建 的 EnemyAnimator 拖 动 到 Inspector 面 板 Animator 下 的 


Controller 中 ， 如 下 图 。 
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(14) 双击 Assets 中 的 EnemyAnimator， 打 开 Animator 窗 口 ， 在 BaseLayer 中 点 击 右键 ， 新 建 三 个 状态 ， 分 别 取 名 为 Idle、Walk、Attack， 如 下 图 。 
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(15) 按 下 图 设置 每 一 个 状态 条 。 
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(16) 将 Walk 和 Lumbering 两 个 动画 设置 为 循环 播放 ， 有 具体 设置 如 下 图 。 
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(17) 在 Animator 面 板 的 状态 条 上 右键 创建 如 下 状态 转换 。 
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(18) 创建 动画 转换 条 件 。 
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(19) 为 每 个 动画 转换 添加 创建 好 的 条 件 。 
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(20) 为 了 进行 碰撞 检测 ， 需 要 为 游戏 对 象 添 加 刚体 组 件 和 碰撞 体 组 件 。 为 Enemy 和 Tower 添 加 Rigidbody 组 件 和 CapsuleCollider 组 件 并 调整 组 件 大 小 以 与 模型 大 小 相 适 应 ， 勾 选 两 个 Rigidbody 组 件 
上 的 UseGravity 选 项 ， 色 选 两 个 CapsuleCollider 组 件 上 的 ISTrigger 组 件 ， 在 Scene 中 选中 敌人 手中 的 斧子 并 为 其 添加 以 上 两 个 组 件 ， 按 照 同样 的 方式 设置 。 


(21) 创建 血 条 。 在 Photoshop 中 创建 一 个 白色 画布 ， 另 存 为 Blood.jpg。 在 Unity 中 导入 该 图 片 ， 将 其 设置 为 Sprite。 
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(22) 在 Enemy 下 创建 Image， 调 整 Image 和 对 应 Canvas 的 位 置 与 大 小 ， 为 Canvas 设 置 一 个 Tag 并 取 名 为 EnemyLife， 将 Blood 拖 动 到 Inspector 面 板 的 Sourcelmage 上 并 按 下 图 设置 。 
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(23) 仿照 上 一 步 为 Tower 做 类 似 设置 。 为 了 方便 查找 ， 


(24) 编写 TowerController 脚 本 。 


给 Tower 下 的 Canvas 添 加 一 个 Tag， 取 名 为 TowerLife。 


using Uni 


Су» 


Engine; 


using Syst 
using Uni 


tem.Collections; 
七 YE 


Engine. UI; 


r 


public class TowerContro] 
ublic GameObject 
nemyCon! 
loat timeGo = Of; 
floa 


ub] 


ler : Monol 
Bullet; 


troller enemycontroller; 


t GuardDistance 300f; 


/ 
dbli 


E £p Ж- 


ee 


loat towerlife 


tO 'O љо bh A'O 


ub] 


ic Trans 


form pos; 


GameObject 
GameObject 
Image image; 


t enemy; 
t canvas; 


Animator ani; 
// Use this for initialization 


void Start 
enemy = 


() 4 
GameObjec 


t.Find("] 


Enemy (C1 
ani = enemy.GetComponent«Animator- 


Behaviour ( 


卫 距 离 ， 当 距离 小 于 这 个 值 时 发 射 子弹 
100f;// 防 御 塔 生命 值 


one) 


() 


KA; 


;// 获 得 敌人 游戏 对 象 
;// 获 得 Animator 组 件 


form.position) ;// 获 取 防 御 塔 和 敌人 之 间 的 距离 


canvas = GameObject.FindGameObjectWithTag ("TowerLife"); 
image = canvas. соо и (); 
// 获 得 Canvas 上 的 Image 进 而 控制 生命 条 的 衰减 
} 
// Update is called once per frame 
void Update () ( 
if (enemy !- null) { 
Float Dis = Vector3.Distance (transform.position, enemy.trans 
if (Dis < GuardDistance) { 


) 


if 


(enemy.GetComponent 


c«EnemyCon 


timeGo += Time.deltaTime; 


timeGo »- 1) 
GenerateBu] 


i 


( 


timeGo = 0; 


let 


0; 
// 当 两 个 游戏 对 象 的 距离 小 于 塔 防御 距离 时 发 射 子弹 


{ 


void OnTriggerEnter (Collider other) 


// 塔 被 攻击 


if 


) 


void Genera 
GameObjec 
bullet. 


(other.gameObject 


.name == "NPC Tools Axe 004") 


— GetComponentsI 


Debug. Log ("防御 塔 被 攻击 ! "); 

towerlife -= 10f; 

image.fillAmount = 

if (towerlife < Of) í 
Renderer[] renderers 
foreach 


troller»().enemyli 


fe»0) { 


{ 


towerlife / 100f; 


nChildren«Renderer» 


(Renderer ren in renderers) { 


ren.material 


.color = Color.black; 


// 当 防御 塔 的 生命 值 小 于 等 于 0 时 将 塔 的 颜色 变 黑 


Id] 


ni.SetBool(" 


teBullet () ( 
t bullet - 


GameObjec 


transform.position 


(25) 编写 EnemyController 脚 本 。 


using Uni 
using Sys 
using Uni 


tyl 
tem.Collections; 
tyl 


Engine; 


Engine.UIl; 


r 


public class 


MonoBe 


EnemyController : 


t. 


haviour í 


e",true);// 同 时 使 得 人 物 动画 切换 为 静止 状态 


Instantiate (Bullet)as GameObject; 
pos.position; 


0; 


public float enemylife = 100f; 
public float Axedamage = 30f; 
loat Walkdistance = 1000f; 
float Attackdistance - 150f; 
float AttackSpeed = LÊ 
Animator ani; 
GameCbject canvas; 
Image image; 
// Use this for initialization 
void Start () ( 
canvas = GameObject.FindGameObjectWithTag ("EnemyLife"); 
image = canvas.GetComponentInChildren«Image» (); 
ani = this.gameObject.GetComponent«Animator» (); 
.SetBool ("Walk", false); 
ve ("Attack", false); 


` 


} 
// Update is called once per frame 
void Update () ( 
GameObject tower = GameObject.Find("Tower (Clone) "); 
// 找 到 游戏 对 象 防御 塔 
if (tower != null) í 
float distance = Vector3.Distance (this.transform.position, tower.transform.position); 
if (distance <= Walkdistance) { 
ani.SetBool ("Walk", true); 
transform.position = Vector3.MoveTowards (this.gameObject.transform.position, tower.transform.position, AttackSpeed);// 让 敌人 以 AttackSpeed 值 走向 防御 塔 
if (distance <= Attackdistance) { 


// 敌 人 和 防御 塔 之 间 的 距离 小 于 攻击 距离 时 ,停止 行走 ， 动 画 切 换 为 攻击 


e Of; 
.SetBool ("Walk", false); 
Mera Acn ("Attack", true); 


} 
} 
void OnTriggerEnter (Collider other) 


{ 
// 当 子弹 打 到 敌人 身上 时 的 控制 


if (other.gameObject.name == "Bullet(Clone)") { 
enemylife -= Bulla damioe: 
image.fillAmount = enemylife/100f; 


if (enemylife <= Of) { 
gameObject .SetActive (false); 
// 当 敌 入 的 血 条 值 小 于 等 于 0 时 ， 将 该 游戏 对 象 关闭 


} 
} 


(26) 编写 Bullet 脚 本 : 


using UnityEngine; 

using System.Collections; 

public class Bullet : MonoBehaviour { 
EnemyController enemycontroller; 

public static float damage = 20; 

GameObject Enemy; 

void Start () í 

Enemy = GameObject.Find ("Enemy (Clone)"); 


} 
void Update () 


{ 
Lf (Enemy.activeSelf) (this.transform.position = Vector3.MoveTowards (this.transform.position, Enemy.transform.position, 5f) :/ /子弹 以 5 个 单位 每 帧 的 速度 射 向 敌人 


1 
) 
else 
{ 


Destroy (this.gameCbject); 


} 
f(transform.position == Enemy.transform.position) 


// 子 弹 攻 击 完 后 自动 销毁 
{ 


Eis 


Destroy (this.gameCbject); 


} 


(27) 将 Hierarchy 中 的 Bullet、Enemy 和 Tower 拖 回 到 Assets 的 Resources 文 件 夹 中 作为 预制 体 ， 并 将 三 者 从 Hierarchy 面 板 中 删除 。 


(28) 游戏 效果 截图 如 下 : 


(29) 至 此 ， 卡 牌 对 战 游戏 基本 制作 完成 ， 本 游戏 还 有 很 多 可 以 提高 的 部 分 ， 大 家 可 以 基于 前 面 学 习 的 内 容 自 己 探索 。 


BIE ЕАК 


本 章 将 给 大 家 讲解 如 何 开发 涂 色 类 AR。 涂 色 类 的 AR 项 目 是 目前 AR 市 场 上 相对 成 功 的 项 目 ， 它 对 SDK 没 有 太 多 的 要 求 ， 我 们 这 里 使 用 的 AR SDK 是 Vuforia。 


UV 坐标 是 指 所 有 的 图 像 文件 都 是 一 个 二 维 平面 。 水 平方 向 是 U， 垂 直方 向 是 V， 通 过 二 维 的 UV 坐标 系 可 以 定位 图 像 上 的 任意 一 个 像素 。 
三 维 物体 在 显示 它 的 表面 纹理 时 ， 往 往 要 借助 平面 贴图 来 实现 ， 那 么 一 个 很 重要 的 问题 就 是 ， 如 何 把 这 个 二 维 平面 贴 到 三 维 物体 的 表面 呢 ? 


这 时 候 我 们 就 需要 对 物体 进行 分 UV 的 处 理 ，“UV” 在 这 里 是 U，V 纹 理 贴图 坐标 的 简称 ( 它 和 空间 模型 的 X，Y，Z 轴 是 类 似 的 ) 。 它 定义 了 图 片上 每 个 点 的 位 置信 息 ， 这 些 点 与 3D 模 型 是 相互 联系 的 ， 


用 以 决定 表面 纹理 贴图 的 位 置 。UV 就 是 将 图 像 上 的 每 一 个 点 精确 对 应 到 模型 物体 的 表面 ， 在 点 与 点 之 间 的 间隙 位 置 由 软件 进行 图 像 光滑 插值 处 理 。 这 就 是 所 谓 的 UV 贴图 。 


比如 正方 体 模型 的 展开 图 : 


= „йш 
Eu das 
`“ 


正方 体 有 11 种 展开 图 ， 上 面 的 这 些 展开 图 都 是 正方 体 的 一 种 UV 贴图 。 
在 涂 色 类 的 AR 项 目 中 ， 对 三 维 物体 的 UV 处 理 是 非常 重要 的 。 我 们 将 在 后 面 给 大 家 具体 介绍 如 何 使 用 3D M ax 对 三 维 模型 的 UV 进行 处 理 ， 这 里 的 UV 处 理 和 传统 的 游戏 模型 UV 处 理 有 所 不 同 。 


学 习 下 一 节 内 容 之 前 ， 大 家 需要 准备 一 个 可 以 在 3D Max 中 打开 的 三 维 模型 ， 该 模型 可 自己 制作 或 在 网 上 下 载 ， 这 里 使 用 的 模型 是 根据 苏 式 战斗 机 的 设计 图 来 简化 制作 的 飞机 模型 。 


SOART — 7 
МР): 自 定 
I | | | 
宽度 (W): 1024 Ir ë ~ RRE)... _ 


高 度 (H): 1024 
HWER): 96.012 


MEM): RGB 颜色 
背景 内 容 (C): x8 


METE HOY: sRGB IECO61966-2.1 
BERAR: 方形 像素 


打开 Photoshop， 新 建 一 个 1024pxx1024px 的 识别 图 ， 这 里 需要 绘制 一 张 用 于 划分 涂 色 区 域 的 黑白 线 稿 


这 里 可 根据 模型 的 设 定 图 来 绘制 涂 色 用 的 黑白 线 稿 ， 这 一 步 使 用 手绘 板 可 以 提高 效率 。 用 选区 的 方式 将 多 余 的 白色 部 分 删除 得 到 以 下 图 片 。 
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也 很 匹配 。 


梵 高 的 《星空 》， 和 模型 的 意义 


的 图 片 作为 背景 图 片 ， 这 里 选择 了 


高 


然后 找 一 张 识别 度 


这 张 图 将 可 以 作为 我 们 的 AR 识别 图 ， 接 下 来 要 根据 这 张 识别 图 来 对 模型 的 UV 进行 具体 处 理 。 


7.3 ”使 用 3D Max 处 理 模 型 的 UV 


打开 3D Max， 如 果 模 型 是 两 边 对 称 的 ， 先 把 模型 的 轴 心 居中 。 
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然后 退出 轴 心 编辑 模式 ， 在 移动 模式 下 将 模型 对 称 的 轴 的 位 置 归 零 ， 这 里 飞机 的 模型 对 称 轴 是 X 轴 ， 所 以 我 们 将 模型 沿 X 方 向 的 位 置 归 零 。 


[+] GÆR j [НЕЕ ШЕН + HR | 


切换 到 项 视图 ， 在 顶点 的 级 别 下 选中 并 删除 一 半 的 顶点 (切记 : 对 称 线 上 的 顶点 不 能 删除 ) 。 
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选择 了 44 趟 顶点 


BERS 
移 除 林 使 用 的 由 图 硕 点 
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HE: пй 


然后 给 模型 添加 对 称 的 修改 器 ， 路 径 为 修改 器 一 网 格 编辑 一 对 称 ， 或 者 在 修改 器 列表 的 下 拉 列 表 框 中 选择 相应 选项 ， 也 可 以 按 下 键盘 上 的 “X” 键 ， 在 弹出 的 查找 框 中 输入 “对 称 ”， 然 后 选择 修改 器 。 
添加 对 称 修 改 器 后 ， 调 整 对 称 修改 器 的 参数 如 下 图 所 示 ， 对 称 轴 选 择 模 型 的 对 称 轴 ， 如 果 模 型 消失 ， 试 着 勾 选 翻转 的 选项 框 ， 一 定 要 把 镜像 级 别 沿 X 方 向 的 位 置 归 零 。 
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拾取 纹理 ， 选 择 位 图 ， 打 开 上 一 节制 作 的 AR 识别 图 。 
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根据 AR 识别 图 ， 将 模型 对 应 位 置 的 UV 对 齐 到 图 片上 的 位 置 ， 如 下 图 所 示 (这 个 过 程 会 很 费时 间 ， 需 要 耐心 将 每 一 处 的 UV 分 好 ) 。 


做 好 之 后 ， 我 们 将 所 有 修改 器 塌陷 ， 再 添加 UVW 展 开 的 修改 器 ， 打 开 UV 编 辑 器 ， 将 另 一 半 机 蝇 的 UV 也 对 应 起 来 ， 其 他 部 分 不 用 改变 。 
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做 好 之 后 将 模型 导出 成 .fbx 格 式 的 文件 ， 导 出 设置 如 下 图 。 
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ТА 搭建 Vuforia AR 开发 环境 


进入 Vuforia 官 网 下 载 SDK， 创 建 项 目 和 数据 库 ， 上 传 我 们 之 前 制作 好 的 识别 图 ， 然 后 下 载 Unity 安 装 包 ， 添 加 ARCamera 和 ImageTarget， 参 考 之 前 章节 设置 好 License Key 和 
Database，lmageTarget 选 择 你 下 载 的 识别 图 。 最 终 做 到 下 面 这 一 步 。 
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(9) V. Audio Listener 
В ¥ vuforia Behaviour (Script) 


App License Key a6V Cn 


Camara Devica Made 
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Max Simultaneous Tracki 1 

Load Object Targets nn ПЁ 

Camera Directan CAMERA DEFAULT 
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World Center Mode FIRST ТАК 


v Digital Eyewear Behaviour (script) 


m Initzit 


Eyeneer T І трёЕ Hense 


IB v perfault Initialization Error Handler (script) 


Project 
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Es Srences : V Web Cam Behaviour (Script) 


= scripts mrs Yufona Play Мос 
ЕЕ Shaders 


Activate 


V Smart Terrain Tracker Behaviour (Script) 


Start Automatically 


这 里 采用 Shader 实 现 从 屏幕 截图 中 获取 我 们 所 需 的 贴图 。 涂 色 类 AR 的 Shader 有 很 多 种 ， 下 面 给 大 家 介绍 其 中 一 个 Shader。 新 建 一 个 Shader 文 件 ， 将 原本 的 内 容 删 除 ， 添 加 以 下 的 代码 : 


Shader " Customer/TuSeARShader" { 
Properties { 
MainTex ("Base (RGB)", 2D) = "white" {} 
| Uvpoint l("point1", Vector) = (0, 0, 0, 0) 
 Uvpoint2("point2", Vector) = (0, 0, 0, 0) 
Uvpoint3("point3", Vector) = (0, 0, 0, 0) 
 Uvpoint4("point4", Vector) = (0, 0, 0 , 0) 


} 
SubShader { 
Tags ( "Queue"2"Transparent" "RenderType"-2"Transparent" } 
LOD 200 
Pass í 
Blend SrcAlpha OneMinusSrcAlpha 
CGPROGRAM 
#pragma vertex vert 
#pragma fragment frag 
#include "UnityCG.cginc" 
sampler2D MainTex; 
float4 MainTex ST; 
Float4  Uvpointl; 
loat4  Uvpoint2; 
oat4  Uvpoint3; 
oat4 Uvpoint4; 
float4x4 VP; 
struct v2f { 
float4 pos : SV POSITION; 
float2 uv : TEXCOORDO; 
float4  fixedPos : TEXCOORD2; 


}; 

v2f vert (appdata base v) 

I 
v2f о; 
o.pos = mul(UNITY MATRIX MVP,v.vertex); 
o.uv = TRANSFORM TEX(v.texcoord, MainTex); 
float4 top = lerp( Uvpointl, Uvpoint3, o.uv.x); 
Float4 bottom = lerp( Uvpoint2,  Uvpoint4, o.uv.x); 
float4 fixedPos = lerp(bottom, top, o.uv.y); 
o.fixedPos = ComputeScreenPos (mul(UNITY MATRIX VP, fixedPos)); 
return o; 

} 

Float4 frag (v2f i) : COLOR 

I 
float4 top = lerp( Uvpointl, _Uvpoint3, i.uv.x); 
float4 bottom = lerp( Uvpoint2,  Uvpoint4, i.uv.x); 
Float4 fixedPos = lerp(bottom, top, i.uv.y); 
fixedPos = ComputeScreenPos (mul ( VP, fixedPos)); 
return tex2D( MainTex, fixedPos.xy / fixedPos.w); 

} 

ENDCG 


我 们 需要 向 这 个 Shader 中 的 6 个 变量 传递 正确 的 值 ，Shader 会 帮 我 们 处 理 好 模型 和 识别 图 的 对 应 关系 ， 下 面 一 一 介绍 这 6 个 变量 . 


loat4  Uvpointl; 
loat4  Uvpoint2; 
loat4  Uvpoint3; 
loat4  Uvpoint4; 


首先 是 以 上 4 个 变量 ， 我 们 要 向 它们 传递 4 个 Vector4 类 型 的 数据 ， 这 4 个 Vector4 数 据 是 ImageTarget 在 世界 空间 中 的 位 置 ， 它 们 的 对 应 天 系 如 下 图 所 示 。 


_Uvpointl _ Uvpoint3 


асе Гагсеї 


. Uvpoint2 . Uvpomt4 


由 于 位 置信 息 是 Vector3， 所 以 要 在 末尾 补 1.0f 凌 成 Vector4。 


float4x4 VP; 


我 们 需要 给 " VP" ERREPU IRAE RERE Ze ASERSIREABSABEERSSIER : 


sampler2D MainTex; 


MainTexture 需 要 传递 的 是 整个 屏幕 的 截图 。 


以 上 6 个 参数 正确 传递 之 后 ， 我 们 的 涂 色 类 AR 项 目的 核心 功能 就 实现 了 ， 下 一 节 将 展示 具体 的 代码 实现 ! 


7.5 ”核心 功能 之 通过 C# 脚 本 获得 变量 


在 Unity 中 创建 一 个 C# 脚 本 ， 命 名 为 ScreenTexture。 以 下 为 该 脚本 的 具体 代码 (基础 较 薄 弱 的 同学 可 以 直接 跳 过 ， 后 面 有 一 步 步 的 讲解 ) 


using UnityEngine; 
using System.Collections; 
public class ScreenTexture : MonoBehaviour 


{ 


public GameObject myFighter; 

private Texture2D screenTexture; 

private Vector3 coordinateTopleft pl w; 
private Vector3 coordinateTopRight pl w; 
private Vector3 coordinateBottomLeft pl w; 
private Vector3 coordinateBottomRight pl w; 
public GameObject plane; 

private Vector2 planeWH; 

void Start () 

I 


} 
public void OnScreenShotButtonClick () 


{ 


ScreenTexture = new Texture2D(Screen.width, Screen.height, TextureFormat.RGB24, false); 


planeWH = new Vector2 (plane.GetComponent«MeshFilter» ().mesh.bounds.size.x, 
plane.GetComponent«MeshFilter»().mesh.bounds.size.z) *5*0.5f;// plane.transform.localScale.x * plane.transform.parent.localScale.x *0.5f 
coordinateTopLeft pl w = plane.transform.parent.position + new Vector3(-plane 
WH. x, 0, planeWH.y); 
coordinateBottomlLeft pl w =  plane.transform.parent.position + new Vector3 
(-planeWH.x, 0, -planeWH.y); 
coordinateTopRight pl w = plane.transform.parent.position + new Vector3 
(planeWH.x, 0, planeWH.y); 


coordinateBottomRight pl w = plane.transform.parent.position + new Vector3 
(planeWH.x, 0, -planeWH.y); 
myFighter.GetComponent«Renderer» ().material.SetVector( 
" Uvpointl",new Vector4(coordinateTopLeft pl w.x,coordinateTopLeft pl w.y,coordinateTopLeft pl w.z,1.0f) 
); 
myFighter.GetComponent«Renderer» ().material.SetVector ( 
" Uvpoint2", new Vector4 (coordinateBottomLeft pl w.x, coordinateBottomLeft pl w.y, coordinateBottomLeft pl w.z, 1.0f) 
); 
myFighter.GetComponent«Renderer» ().material.SetVector ( 
" Uvpoint3", new Vector4 (coordinateTopRight pl w.x, coordinateTopRight pl w.y, coordinateTopRight pl w.z, 1.0f) 
); 
myFighter.GetComponent«Renderer» ().material.SetVector ( 
" Uvpoint4", new Vector4 (coordinateBottomRight pl w.x, coordinateBottomRight pl w.y, coordinateBottomRight pl w.z, 1.0f) 
); 
Matrix4x4 P = GL.GetGPUProjectionMatrix (Camera.main.projectionMatrix, false); 
Matrix4x4 V = Camera.main.worldToCameraMatrix; 
Matrix4x4 VP = P * V; 
myFighter.GetComponent«Renderer» ().material.SetMatrix (" VP",VP); 
screenTexture.ReadPixels (new Rect(0, 0, screenWidth, screenHeight), 0, 0); 
ScreenTexture.Apply(); 
myFighter.GetComponent«Renderer»().material.mainTexture = textureShot; 


接 下 来 ， 我 们 来 看 这 个 脚本 的 内 容 。 根 据 上 一 节 的 内 容 ， 需 要 给 Shader 传 递 6 个 参数 ， 那 么 我 们 先 来 分 析 这 6 个 变量 。 


为 了 获得 MainTexture， 我 们 需要 申请 一 个 Texture2D 的 变量 


private Texture2D screenTexture; 


在 Start0 函 数 中 对 它 进行 初始 化 : 


ScreenTextur 


= new Texture2D(Screen.width, Screen.height, TextureFormat.RGB24, 


false); 


Screen.width 和 Screen.height 是 图 片 的 宽 和 高 ，TextureFormat.RGB24 是 图 片 的 模式 ，false 是 不 使 用 纹理 分 级 


在 屏幕 截取 函数 里 得 到 整个 屏幕 的 图 像 


screenTexture.ReadPixels (new 
void ReadPixels (source 


Rect(0, 0, screenWidth, screenHeight), 
: Rect, destX : int, destY : int, 


0, 0); 
recalculateMipMaps 


: bool = true) 


读 取 屏 幕 像素 信息 并 存储 为 纹理 数据 ， 


屏幕 左下 角 。 


如 果 recalculateMipMaps 设 置 为 真 ， 那 么 这 个 贴图 的 mipmaps 就 会 更 新 。 


如 果 recalculateMipMaps 设 置 为 假 ， 则 需要 调用 Apply 重 新 计算 它们 。 


这 个 为 


数 只 工作 在 格式 为 ARGB32 和 RGB24 的 纹理 上 ， 另 外 这 个 纹理 的 导入 设置 需要 设置 为 ls Readable (可 读 ) 。 


获取 截图 之 后 一 定 要 调用 


ScreenTexture.Apply(); 


MAERAH, DCEENUXIS T 98—124, 3AIESXISGPUBSISSZRBEERTTE PRAAERSITREVBSABEERSSIEER, 
GPU 的 投影 矩阵 为 : 


Matrix4x4 P = GL.GetGPUProjectionMatrix (Camera.main.projectionMatrix, 


False); 


世界 坐标 到 相机 的 矩阵 为 : 


Matrix4x4 V = Camera.main.worldToCameraMatrix; 


Tre HEX: 
Matrix4x4 VP = 


P*V; 


然后 获得 4 个 Vector4 类 型 的 数据 。4 个 类 型 的 数据 并 不 能 直接 从 ImageTarget 上 获得 ， 所 以 我 们 采取 的 做 法 是 得 到 它们 的 近似 值 。 


а 将 它 放 在 ImageTarget 下 面 作 为 其 子 物 体 ， 调 整 plane 物 体 的 X 和 Z 的 缩放 值 来 保证 它 和 ImageTarget 大 小 一 样 ， 然 后 将 plane 的 Y 轴 位 置 向 上 移动 0.001， 


该 尽 可 能 小 ， 因 为 我 们 要 用 plane 的 4 个 点 位 置 来 近似 地 代替 ImageTarget 的 4 个 点 的 位 置信 息 。 


这 将 从 当前 处 于 激活 状态 的 RenderTexture 或 视图 (由 source 指定 ) 复制 一 个 由 destX 和 destY 指 


定 的 矩形 像素 区 域 。 这 两 个 坐标 使 用 像素 空间 坐标 (0, 0) 表示 


里 的 数值 应 
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为 了 得 到 这 4 个 点 的 位 置信 息 ， 设 plane 的 位 置 为 (a，b，c) ， 宽 为 2x， 高 为 2y。 


TopLetft TopRieht 


由 简单 的 数学 运算 可 得 到 : 


TopLeft : (а-х,р,с+у) 
TopRight: (а+х, р, с+у) 
BottomLeft: (a-x,b,c-y) 
BottomRight: (а+х,Ю, с-у) 


我 们 首先 声明 两 个 变量 : 


public GameObject plane; 
private Vector2 planeWH; 


前 者 用 于 存储 场景 中 的 plane 物 体 ， 后 者 用 于 存储 场景 中 plane 物 体 的 X 轴 和 2Z 轴 的 距离 的 一 半 。 


再 申请 4 个 Vector3 来 存放 4 个 点 的 位 置 。 


private Vector3 coordinateTopleft pl w; 
private Vector3 coordinateTopRight pl w; 
private Vector3 coordinateBottomLeft pl w; 
private Vector3 coordinateBottomRight pl w; 


在 屏幕 截取 的 函数 中 ， 先 得 到 plane 物 体 的 X 轴 和 Z 轴 距离 的 一 半 ， 即 得 到 planeWH 的 值 。 


planeWH = new Vector2 


lane.GetComponent«MeshFilter» ().mesh.bounds.size.x* 
ane.transform.localScale.x * 
ane.transform.parent.localScale.x, 
lane.GetComponent«MeshFilter» ().mesh.bounds.size.z* 
lane.transform.localScale.z * plane.transform.parent.localScale.z 
хоре; 
lane.GetComponent«MeshFilter» ().mesh.bounds.size.x 


O —'U O O OO ~ 


上 述 语句 的 返回 值 是 plane 这 个 物体 的 网 格 的 包围 体 沿 X 轴 的 长 度 。 
SERE 


需要 给 Shader 传 递 的 是 ImageTareet 世 界 中 的 位 置 ， 这 里 用 plane 子 物体 的 位 置 来 做 近似 ， 所 以 必须 用 plane 相 对 世界 的 缩放 值 。 而 plane 物 体 的 缩放 值 是 相对 于 ImageTarget 的 ， 所 以 要 用 plane 的 缩放 值 乘 以 其 父 
物体 的 缩放 值 ， 得 到 的 才 是 相对 世界 的 缩放 值 。 


最 后 再 乘 0.5f， 取 得 它 的 一 半 值 。 
Plane.transform.position 可 以 返回 plane 的 位 置 ， 即 (a, b, c) 的 值 。 


套用 上 面 的 数学 公式 可 得 到 : 


coordinateTopLeft pl w = plane.transform.parent.position + new Vector3(-planeWH.x, 0, planeWH.y); 
coordinateBottomlLeft pl w = plane.transform.parent.position + new Vector3(-planeWH.x, 0, -planeWH.y); 
coordinateTopRight pl w = plane.transform.parent.position + new Vector3(planeWH.x, 0, planeWH.y); 
coordinateBottomRight pl w = plane.transform.parent.position + new Vector3(planeWH.x, 0, -planeWH.y); 


7.6 “核心 功能 之 通过 C# 脚 本 向 Shader 传 递 变量 


获取 了 这 6 个 变量 之 后 ， 需 要 向 Shader 中 传递 这 6 个 变量 的 值 。 


首先 申请 一 个 共有 的 GameObject 物 体 ， 这 个 物体 就 是 我 们 的 模型 物体 。 


public GameObject myFighter; 


保存 之 后 回 到 Unity， 将 导入 的 模型 放 在 ImageTarget 下 面 ， 并 调整 它 的 大 小 和 旋转 方向 。 
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新 建 一 个 材质 球 ， 改 名 为 Fighter_ mat， 将 它 的 Shader 改 为 我 们 之 前 写 的 Shader， 路 径 是 CustomerTuSeARShader。 


将 这 个 材质 球 赋值 给 我 们 的 模型 ， 接 下 来 需要 将 模型 透明 显示 ， 在 Photoshop 中 创建 一 个 透明 的 贴图 ， 大 小 为 32pxx32px 即 可 。 
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将 图 层 的 不 透明 度 改 为 0%， 然 后 保存 成 ,png 格式 ， 导 出 到 Unity 中 。 
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Wrap Mode "Clamp 
Filter Mode | Bilinear 
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Max Size 
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片 的 属性 如 上 图 所 示 ， 将 该 图 片 赋值 给 模型 的 MainTexture， 即 可 实现 透明 显示 。 
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用 同样 的 方法 实现 plane 物 体 的 透明 显示 ，Shader 使 用 的 是 Mobile/Particles/Additive。 
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Add Component 


新 建 一 个 空 物体 ， 命 名 为 ScriptsGameObject， 将 上 面 的 脚本 拖 给 它 ， 将 plane 和 模型 物体 拖 给 脚本 。 
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ScriptsGameObject 
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V Screen Texture 1 (Script) 
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回 到 脚本 中 ， 在 屏幕 截图 函数 中 对 变量 进行 赋值 。 


Vector4 变 量 的 赋值 : 


myFighter.GetComponent«Renderer» ().material.SetVector( 
" Uvpointl",new Vector4(coordinateTopleft pl w.x,coordinateTopleft 
pl w.y,coordinateTopLeft pl w.z,l1.0f) 


у 4 / ЖЕ 
myFighter.GetComponent«Renderer» ().material.SetVector ( 
" Uvpoint2", new Vector4 (coordinateBottomLeft pl w.x, coordinateBottomLeft pl w.y, coordinateBottomLeft pl w.z, 1.0f) 
);//ж T 
myFighter.GetComponent<Renderer> ().material.SetVector ( 
" Uvpoint3", new Vector4 (coordinateTopRight pl w.x, coordinateTopRight pl w.y, coordinateTopRight pl w.z, 1.0f) 
);// 右 上 
myFighter.GetComponent«Renderer» ().material.SetVector ( 
" Uvpoint4", new Vector4 (coordinateBottomRight pl w.x, coordinateBottomRight pl w.y, coordinateBottomRight pl w.z, 1.0f) 
);// 右 下 
和 矩阵 的 赋值 : 
myFighter.GetComponent«Renderer» ().material.SetMatrix (" VP' ,VP); 


MainTextureB у B : 


myFighter.GetComponent«Renderer» ().material.mainTexture = textureShot; 


回 到 Unity 中 ， 添 加 一 个 截图 的 Button ， 将 ScriptsGameObject 物 体 拖 至 它 的 OnClick 事 件 中 ， 并 选 定 屏幕 截图 函数 。 
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识别 到 识别 图 时 ， 按 下 截图 按钮 就 能 正确 显示 模型 颜色 ， 至 此 ， 涂 色 类 AR 的 核心 功能 已 经 实现 了 ， 我 们 可 以 在 此 功能 的 基础 上 进行 扩展 ， 做 出 自己 的 涂 色 类 AR 项 目 。 


第 8 章 ”使 用 陀螺 仪 模拟 SLAM 功 能 


8.1 _SLAM 的 概念 


在 介绍 本 章 内 容 之 前 ， 先 给 大 家 介绍 一 下 什么 是 SLAM (Simultaneous localization and mapping) 。SLAM 的 含义 是 即时 定位 与 地 图 构建 ， 或 并 发 建 图 与 定位 ， 是 实现 真正 全 自主 移动 机 器 人 的 关 
键 。 在 AR 领域 ， 我 们 用 SLAM 来 对 周围 的 空间 进行 扫描 和 三 维 空间 重建 ， 然 后 在 重建 的 位 置 放置 虚拟 物体 ， 实 现 增 强 现实 的 目的 。 


实现 真正 的 SHAM 功 能 需要 涉及 很 多 数学 知识 ， 以 及 对 RGB 图 像 和 深度 图 像 的 处 理 等 等 ， 这 些 内 容 并 不 在 本 章 的 范围 之 内 ， 有 兴趣 的 读者 可 以 自行 搜索 资源 进行 学 习 ! 


第 8 章 ”使 用 陛 螺 仪 模拟 SLAM 功 能 


8.1 ” SLAM 的 概念 


在 介绍 本 章 内 容 之 前 ， 先 给 大 家 介绍 一 下 什么 是 SLAM (Simultaneous localization and mapping) 。SLAM 的 含义 是 即时 定位 与 地 图 构建 ， 或 并 发 建 图 与 定位 ， 是 实现 真正 全 自主 移动 机 器 人 的 关 
键 。 在 AR 领域 ， 我 们 用 SLAM 来 对 周围 的 空间 进行 扫描 和 三 维 空间 重建 ， 然 后 在 重建 的 位 置 放置 虚拟 物体 ， 实 现 增强 现实 的 目的 。 


实现 真正 的 SHAM 功 能 需要 涉及 很 多 数学 知识 ， 以 及 对 RGB 图 像 和 深度 图 像 的 处 理 等 等 ， 这 些 内 容 并 不 在 本 章 的 范围 之 内 ， 有 兴趣 的 读者 可 以 自行 搜索 资源 进行 学 习 ! 


82 ”模拟 SLAM 功 能 的 实现 


首先 给 大 家 介绍 一 下 本 节 最 终 实现 的 效果 : 


我 们 不 借助 识别 图 或 者 其 他 识别 信息 ， 直 接 在 屏幕 中 看 到 一 个 绿色 的 Box， 当 手机 移 开 时 ，Box 会 消失 ， 再 回来 的 时 候 ， 绿 色 的 Box 还 会 出 现在 这 个 位 置 。 


实现 原理 是 : 场景 中 放置 两 个 camera， 一 个 是 ARCamera， 用 来 调用 摄像 头 以 显示 真实 世界 ， 另 一 个 Camera 用 来 泻 染 虚 拟 物体 ， 这 里 指 的 是 绿色 的 Box， 然 后 用 陀螺 仪 来 控制 第 二 个 摄像 机 的 旋转 ， 
这 样 就 可 以 模拟 SLAM 的 效果 。 


由 于 传感器 的 误差 、 波 动 等 一 系列 因素 的 影响 ， 如 果 直 接 使 用 而 不 进行 滤波 处 理 ， 效 果 势 必 会 不 稳定 ， 所 以 我 们 采用 的 解决 办 法 是 引入 第 三 方 插件 [GyroDroid]。 


首先 打开 Unity， 创 建 一 个 新 的 工程 ， 将 GyroDroid 和 Vuforia 的 SDK 导 入 该 工程 ， 再 新 建 一 个 文件 夹 存放 我 们 制作 的 内 容 。 
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创建 一 个 材质 球 ， 将 颜色 设置 为 绿色 ， 并 把 该 材质 赋 给 Cube。 


新 建 一 个 Layer (ER) ， 命 名 为 SiamObjects。 


Tags 
Sorting Layers 


Layers 


Los EL SES E нЕ 


Вип Layer Û Default 


Builtin Laver 1  TransparentFX 


Builtin Layer 2 Ignore Raycast 


Builtin Layer : 

Builtin Layer 4 Water 
Builtin Layer 5 ШІ 
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User Layer B SlamoObjects 
User Layer 9 

User Layer 10 


然后 将 Cube 的 Layer 设 置 为 SiamObjects。 
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然后 设置 ARCamera 下 Camera 的 Clear Flags73Depth only，CullingMask 的 属性 改 为 Default， 这 样 ARCamera 将 不 会 泻 染 绿色 的 Cube。 
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Projection | Perspective + | 
Field of View — — | Г; ]. 
Clipping Planes Near 0.05 
Far 2000 
Viewport Rect | I 
X!0 YD 
W1 H1 
Depth -1 
Rendering Path „Use Player Settings — + | 
Target Texture None (Render Textu| © 
Occlusion Culling ММ 
HDR = 
Y |с M Video Background Behaviour] T, 
Script VideoBackground| © 


ш |_| Flare Layer 2 


= (= MHide Excess Area Behaviour 2. 
Script HideExcessAreaB: © 


Add Component 


E==== = ======ə = 3]‏ ڪڪ س ڪڪ ڪڪ 


这 里 我 们 用 ARCamera 只 是 为 了 调用 外 部 摄像 头 ， 还 可 以 用 WebCcamTexture 来 实现 ， 大 家 可 以 自己 研究 。 这 里 我 们 需要 给 ARCamera 添 加 License Key， 添 加 方法 前 面 已 经 多 次 介绍 过 了 ， 这 里 就 不 再 
重复 。 


接 下 来 ， 编 写 代 码 实 现 用 陀螺 仪 和 加 速 计 控制 摄像 机 的 旋转 ， 新 建 一 个 CameraRotate 的 C# 脚 本 ， 然 后 将 它 拖 给 MainCamera。 
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在 该 脚本 中 编写 以 下 代码 : 


using UnityEngine; 
using System.Collections; 
public class CameraRotate : MonoBehaviour 


{ 


void Start () 
{ 


} 
void Update () 
{ 


SensorHelper.ActivateRotation() ;// 激 活 旋转 传感器 


transform.rotation = SensorHelper.rotation; 


// 让 该 物体 的 旋转 和 手机 陀螺 仪 的 旋转 一 致 


代码 非常 简单 ， 大 家 看 注释 即 可 。 完 成 之 后 打包 项 目 到 Android 平 台 上 测试 ， 实 现 模拟 SAM 的 功能 ! 


第 9 章 ”Unity 与 原生 代码 之 间 的 交互 


9.1 Unity 与 Android 原 生 代码 之 间 的 交互 
在 我 们 开发 AR 产 品 的 过 程 中 ， 常 常 需要 与 系统 原生 代码 进行 相互 调用 ， 因 为 自前 大 部 分 AR 应 用 都 是 用 C#、JavaScript 配 合 Unity 3D 进 行 开发 ， 而 大 部 分 传统 应 用 都 是 使 用 原生 语言 开发 ， 比 如 Android 
系统 采用 java 语言 开发 ， 而 iOS 系 统 采用 Objective-C 或 Swift 进行 开 友 。 这 样 我 们 不 可 避免 地 需要 在 Unity 中 调用 Android 原 生 接 口 ， 或 从 Objective-C 给 Unity 接 口 友 送 消息 。 


本 节 我 们 重点 讲述 Unity 与 Android 原 生 代码 之 间 的 相互 调用 。 要 实现 这 个 功能 ， 我 们 必须 要 对 Android 系 统 开发 和 Unity 开 发 都 有 比较 透彻 的 了 解 。 相 信和 阅读 本 书 的 读者 对 于 Unity 的 掌握 程度 会 比较 
好 ,但 是 对 Android 开 发 并 不 一 定 很 了 解 ， 因 此 我 们 首先 来 简要 介绍 一 下 Android 开 发 的 基础 知识 。 


1. 开 发 环境 


Android 开 发 环境 主要 是 Eclipse 和 Android studio， 本 节 内 容 主要 是 在 Eclipse 下 进行 讲述 ， 如 果 你 还 没有 在 Eclipse 下 配置 好 Android 开 发 环境 ， 请 先 按 照 以 下 步骤 下 载 、 安 装 和 配置 环境 。 


(1) 下 载 并 安装 JDK (Java Development Kit) ，JDK 是 Java 开 发 工具 包 ， 因 为 Android 系 统 是 用 Java 进 行 编写 的 ， 所 以 我 们 需要 确保 Java 的 正常 运行 。JDK 安 装 完成 后 ， 需 要 配置 环境 变量 ， 环 境 变 
量 的 配置 过 程 比 较 简 单 ， 只 需要 在 谷歌 或 百度 上 搜索 步骤 即 可 。 


(2) 下 载 并 安装 Android SDK (Android Software Development Kit) , Android SDK 是 指 Android 软 件 开 发 工具 包 ， 从 谷歌 开发 者 官网 获得 后 进行 安装 ， 并 在 SDK Manager 工 具 中 选择 Android 某 
一 版 本 进行 下 载 安装 。 


(3) 在 Eclipse 中 配置 并 指定 Android SDK。 
2. 工 程 结 构 


开发 环境 配置 完成 后 ， 我 们 可 以 新 建 一 个 Android 工 程 ， 下 面 将 通过 这 个 工程 讲解 Android 的 工程 结构 。 新 建 工程 如 下 图 所 示 。 


© New Android Application v 


New Android Application 


Creates a new Android Application 


Application Name: B AndroidAR 
Project Named Android AR 


P ackaqe Narne:B com.arinchina.ar 


Minimum Required SDK:B | APIS: Android 2.2 (Froyo) 


Target SDK:B | АРІ 21: Android 4.X (L Preview) 


Compile Wirth: B АР] 23: Android 6.0 


在 新 建 的 工程 中 主要 有 以 下 文件 目录 结构 : 
(1) src: 所 有 逻辑 和 功能 相关 的 Java 文 件 。 
(2) gen: 自动 生成 的 Java 文 件 ， 这 里 面 主要 有 两 个 java 文件 ， 分 别 为 Rjava 和 BuildConfigjava， 前 者 的 功能 是 对 资源 文件 进行 索引 ， 后 者 主要 是 配置 文件 。 
(3) assets: 用 于 存放 资源 ， 在 该 目录 下 的 资源 文件 并 没有 在 Rjava 中 生成 索引 ， 访 问 时 需要 用 AssetsManager 类 进行 访问 ， 一 般 都 是 通过 文件 路 径 进行 访问 操作 。 


(4) res: 用 于 存放 资源 ， 与 assets 目 录 不 同 的 是 ， 所 有 在 res 下 的 资源 都 会 在 Rjava 中 生成 对 应 的 ID， 在 访问 这 些 资源 的 时 候 都 是 通过 这 个 ID 进行 访问 的 ， 因 此 如 果 某 个 资源 没有 用 到 ， 该 资源 是 不 会 
打包 进程 序 最 终 的 文件 里 的 ， 而 assets 目 录 下 的 资源 则 会 全 部 打包 进程 序 文件 。 


(5) libs: 该 目录 主要 存放 项 目 引用 到 的 类 库 以 及 第 三 方 库 。 
(6) AndroidManifest.xml 文 件 : 该 文件 是 当前 工程 的 总 配置 文件 ， 在 该 文件 中 定义 了 SDK 版 本 号 、 所 有 的 Activity 以 及 该 应 用 会 调用 系统 的 哪些 特性 等 一 系列 配置 需求 。 


3. 将 Unity 工 程 导 出 为 Android 工 程 


一 般 情况 下 ， 我 们 是 直接 在 Unity 中 导出 Android 安 装 文件 ， 即 apk 文 件 ， 但 是 要 做 到 Unity 的 App 与 Android 原 生 App 之 间 的 融合 ， 必 须要 将 Unity 工 程 导出 为 Android 工 程 。 导 出 Android 工 程 的 方法 比 
较 简单 ， 只 需要 在 Build Settings 中 选中 Google Android Project 选 项 ， 然 后 点 击 Export 即 可 导出 Android 工 程 。 


4. 实 现 原生 界面 与 Unity 界 面 交互 功能 
用 Eclipse 打开 从 Unity 导 出 的 工程 ， 我 们 可 以 看 到 该 工程 中 有 UnityPlayerActivity.java 这 个 文件 ， 这 就 是 我 们 进行 Unity 与 Android 互 通 的 关键 所 在 ， 其 实 Unity 的 界面 都 是 由 UnityPlayerActivity 进 行 管 


理 的 ， 而 UnityPlayerActivity 这 个 类 本 身 是 继承 自 Activity 类 的 。Activity 是 Android 系 统 的 五 大 组 件 之 一 ， 通 常 称 为 活动 ， 其 管理 的 目标 可 以 认为 是 界面 ， 从 一 个 界面 切换 到 另外 一 个 界面 都 是 由 Activity 之 
间 的 切换 来 实现 的 。 


Scenes In Build 


接 下 来 ， 我 们 在 Unity 的 3D 界 面前 添加 一 个 Android 原 生 界 面 : 


(1) 创建 新 的 Activity 文 件 。 


// 原 生 界面 
/ /MainMenuActivity.java 
public class MainMenuActivity extends Activity 
I 
QOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
this.setContentView (R.layout.mainmenu); 
// 查 询 界 面 上 的 按钮 
Button btn = (Button)this.findViewByld(R.id.startButton); 
// 给 按钮 添加 点 击 事件 ， 并 让 它 切 换 到 Unity 的 Acitivity 
btn.setOnClickListener (new OnClickListener() { 
GOverride 
public void onClick(View v) Í 
Intent it = new Intent(); 
it.setClass (MainMenuActivity.this, UnityPlayerActivity.class); 
MainMenuActivity.this.startActivity (it); 


(2) 创建 原生 界面 布局 文件 mainmenu.xml。 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android: layout height-2"match parent" 
android:orientation-"vertical" » 


«Button android:id = "(-4id/startButton" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 


android;text = "estring/start button" 
android:clickable-"true"/» 
«/LinearLayout» 


(3) 在 AndroidManifest 文 件 中 设置 原生 Activity 为 启动 界面 。 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" package-"com.Move.AU" android:versionName-"1.0" android:versionCode-"1" android:installLocation-"preferExte 
«supports-screens android:smallScreens-"true" android:normalScreens-"true" android:largeScreens-"true" android:xlargeScreens-"true" android:anyDensity-"true" /> 
«application android:theme-"8style/UnityThemeSelector" android:icon-"8drawable/app icon" android:label-"G8string/app name" android:isGame-"true" android:banner-"Qdrawable/app 

«activity android:label-"G8string/app name" android:screenOrientation-"fullSensor" android:launchMode-"singleTask" android:configChanges-"mcc |mnc | locale | touchscreen | keyboarc 
«meta-data android:name-"unityplayer.UnityActivity" android:value-"true" /> 
«/activity» 
«activity android:label-"G8string/app name" android:screenOrientation-"fullSensor" android:configChanges-"mcc |mnc|1locale|touchscreen|keyboard|keyboardHidden|navigation|orie 
«intent-filter» i 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«category android:name-"android.intent.category.LEANBACK LAUNCHER" /» 
«/intent-filter» i 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" android:targetSdkVersion-"23" /> 
«uses-feature android:glEsVersion-"0x00020000" /» 
«uses-feature android:name-"android.hardware.touchscreen" android:required-"false" /» 
«uses-feature android:name-"android.hardware.touchscreen.multitouch" android: 
required-" false" /» 


«uses-feature android:name-"android.hardware.touchscreen.multitouch.distinct" android:required-"false" /» 
«/manifest» 


在 上 面 的 xml 文 件 中 可 以 看 到 ， 我 们 将 主 Acitivity 和 局 动 界 面 设 置 为 MainMenuActivity， 而 不 是 原本 的 UnityPlayerActivity。 


通过 上 述 步 又， 我 们 可 以 让 App 的 启动 界面 为 Android 原 生 界面 ， 然 后 跳 转 到 Unity 界 面 ， 接 下 来 ， 我 们 再 实现 从 Unity 界 面 跳 转 至 Android 原 生 界 面 的 功能 。 


(4) 在 Unity 中 创建 场景 ， 并 添加 一 个 按钮 。 


(5) 创建 Game.cs 脚 本 ， 并 添加 以 下 代码 : 


using UnityEngine; 
using System.Collections; 
public class Game : MonoBehaviour 


// 点 击 返回 按钮 时 调用 
public void OnBackButtonClick() 
{ 


using (AndroidJavaClass jc = new AndroidJavaClass ("com.unity3d.player.UnityPlayer")) 


using (AndroidJavaCbject jo = jc.GetStatic«AndroidJavaObject» ("currentActivity")) 
{ 


/ Hf] Androiddéft PUnityPlayerActivityfjStartActivity0Zrik 
//stringToEdit 表 示 它 的 参数 
jo.Call("BackToMenu", "msg"); 


(6) 在 UnityPlayerActivity 中 添加 BackToMenu 遂 数 ， 在 该 函数 中 调用 切换 界面 功能 。 


public void BackToMenu (String msg) 

{ 
this.runOnUiThread (new Runnable () 
{ 


public void гип () 


// 切 换 到 主 界 面 功 能 
Intent it = new Intent(); 
it.setClass (UnityPlayerActivity.this, MainMenuActivity.class); 
UnityPlayerActivity.this.startActivity (it); 


} 
}); 


上 述 步骤 完成 后 ， 我 们 就 可 以 实现 Android 原 生 代 码 与 Unity 代 码 之 间 的 交互 功能 。 
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在 我 们 开发 AR 产 品 的 过 程 中 ， 常 常 需要 与 系统 原生 代码 进行 相互 调用 ， 因 为 目前 大 部 分 AR 应 用 都 是 用 C#、JavaScript 配 合 Unity 3D 进 行 开发 ， 而 大 部 分 传统 应 用 都 是 使 用 原生 语言 开发 ， 比 如 Android 
系统 采用 Java 语 言 开发 ， 而 iOS 系 统 采 用 Objective-C 或 swift 进行 开发 。 这 样 我 们 不 可 避免 地 需要 在 Unity 中 调用 Android 原 生 接 口 ， 或 从 Objective-C 给 Unity 接 口 发 送 消息 。 


本 节 我 们 重点 讲述 Unity 与 Android 原 生 代码 之 间 的 相互 调用 。 要 实现 这 个 功能 ， 我 们 必须 要 对 Android 系 统 开发 和 Unity 开 发 都 有 比较 透彻 的 了 解 。 相 信和 阅读 本 书 的 读者 对 于 Unity 的 掌握 程度 会 比较 
好 ， 但 是 对 Android 开 发 并 不 一 定 很 了 解 ， 因 此 我 们 首先 来 简要 介绍 一 人 Android 开 发 的 基础 知识 。 


Android 开 发 环境 主要 是 Eclipse 和 Android Studio， 本 节 内 容 主 要 是 在 Eclipse 下 进行 讲述 ， 如 果 你 还 没有 在 Eclipse 下 配置 好 Android 开 发 环境 ， 请 先 按照 以 下 步骤 下 载 、 安 装 和 配置 环境 。 


(1) 下 载 并 安装 JDK (ava Development Kit) ，JDK 是 Java 开 发 工具 包 ， 因 为 Android 系 统 是 用 Java 进 行 编写 的 ， 所 以 我 们 需要 确保 Java 的 正常 运行 。JDK 安 装 完成 后 ， 需 要 配置 环境 变量 ， 环 境 变 
量 的 配置 过 程 比 较 简单 ， 只 需要 在 谷歌 或 百度 上 搜索 步骤 即 可 。 


(2) 下 载 并 安装 Android SDK (Android Software Development Kit) , Android SDK 是 指 Android 软 件 开 发 工具 包 ， 从 谷歌 开发 者 官网 获得 后 进行 安装 ， 并 在 SDK Manager 工 具 中 选择 Android 某 
一 版 本 进行 下 载 安装 。 


(3) 在 Eclipse 中 配置 并 指定 Android SDK。 
2. 工 程 结构 


开发 环境 配置 完成 后 ， 我 们 可 以 新 建 一 个 Android 工 程 ， 下 面 将 通过 这 个 工程 讲解 Android 的 工程 结构 。 新 建 工程 如 下 图 所 示 。 
& New Android Application ES 


New Android Application 


Creates a new Android Application 


Application Name: B AndroidAR 


Project Мате AndroidAR 


Package Мате 8 com.arinchina.ar 


Minimum Required 50К:8 API 8: Android 2.2 (Froyo) 
Target SDK:B API 21: Android 4.X (L Preview) 


Compile With: B API 23: Android 6.0 


在 新 建 的 工程 中 主要 有 以 下 文件 目录 结构 : 
(1) src: 所 有 逻辑 和 功能 相关 的 Java 文 件 。 
(2) gen: 自动 生成 的 Java 文 件 ， 这 里 面 主 要 有 两 个 java 文件 ， 分 别 为 Rjava 和 BuildConfig.java， 前 者 的 功能 是 对 资源 文件 进行 索引 ， 后 者 主要 是 配置 文件 。 
(3) assets: 用 于 存放 资源 ， 在 该 目录 下 的 资源 文件 并 没有 在 Rjava 中 生成 索引 ， 访 问 时 需要 用 AssetsManager 类 进行 访问 ， 一 般 都 是 通过 文件 路 径 进行 访问 操作 。 


(4) res: 用 于 存放 资源 ， 与 assets 目 录 不 同 的 是 ， 所 有 在 res 下 的 资源 都 会 在 Rjava 中 生成 对 应 的 ID， 在 访问 这 些 资源 的 时 候 都 是 通过 这 个 ID 进行 访问 的 ， 因 此 如 果 某 个 资源 没有 用 到 ， 该 资源 是 不 会 
打包 进程 序 最 终 的 文件 里 的 ， 而 assets 目 录 下 的 资源 则 会 全 部 打包 进程 序 文件 。 


(5) libs: 该 目录 主要 存放 项 目 引 用 到 的 类 库 以 及 第 三 方 库 。 
(6) AndroidManifest.xm| 文 件 : 该 文件 是 当前 工程 的 总 配置 文件 ， 在 该 文件 中 定义 了 SDK 版 本 号 、 所 有 的 Activity 以 及 该 应 用 会 调用 系统 的 哪些 特性 等 一 系列 配置 需求 。 
3. 将 Unity 工 程 导 出 为 Android 工 程 


一 般 情 况 下 ， 我 们 是 直接 在 Unity 中 导出 Android 安 装 文件 ， 即 apk 文 件 ， 但 是 要 做 到 Unity 的 App 与 Android 原 生 App 之 间 的 融合 ， 必 须要 将 Unity 工 程 导 出 为 Android 工 程 。 导 出 Android 工 程 的 方法 比 
较 简单 ， 只 需要 在 Build Settings 中 选中 Google Android Project 选 项 ， 然 后 点 击 Export 即 可 导出 Android 工 程 。 


4. 实 现 原生 界面 与 Unity 界 面 交 互 功能 


用 Eclipse 打开 从 Unity 导 出 的 工程 ， 我 们 可 以 看 到 该 工程 中 有 UnityPlayerActivityjava 这 个 文件 ， 这 就 是 我 们 进行 Unity 与 Android 互 通 的 关键 所 在 ， 其 实 Unity 的 界面 都 是 由 UnityPlayerActivity 进 行 管 
理 的 ， 而 UnityPlayerActivity 这 个 类 本 身 是 继承 自 Activity 类 的 。Activity 是 Android 系 统 的 五 大 组 件 之 一 ， 通 常 称 为 活动 ， 其 管理 的 目标 可 以 认为 是 界面 ， 从 一 个 界面 切换 到 另外 一 个 界面 都 是 由 Activity 之 
间 的 切换 来 实现 的 。 


Scenes In Build 


接 下 来 ， 我 们 在 Unity 的 3D 界 面前 添加 一 个 Android 原 生 界 面 : 


(1) 创建 新 的 Activity 文 件 。 


// 原 生 界面 
/ /MainMenuActivity.java 
public class MainMenuActivity extends Activity 
I 
QOverride 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
this.setContentView (R.layout.mainmenu); 
// 查 询 界 面 上 的 按钮 
Button btn = (Button)this.findViewByld(R.id.startButton); 
// 给 按钮 添加 点 击 事件 ， 并 让 它 切 换 到 Unity 的 Acitivity 
btn.setOnClickListener (new OnClickListener() { 
GOverride 
public void onClick(View v) Í 
Intent it = new Intent(); 
it.setClass (MainMenuActivity.this, UnityPlayerActivity.class); 
MainMenuActivity.this.startActivity (it); 


(2) 创建 原生 界面 布局 文件 mainmenu.xml。 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android: layout height-2"match parent" 
android:orientation-"vertical" » 


«Button android:id = "(-4id/startButton" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 


android;text = "estring/start button" 
android:clickable-"true"/» 
«/LinearLayout» 


(3) 在 AndroidManifest 文 件 中 设置 原生 Activity 为 启动 界面 。 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" package-"com.Move.AU" android:versionName-"1.0" android:versionCode-"1" android:installLocation-"preferExte 
«supports-screens android:smallScreens-"true" android:normalScreens-"true" android:largeScreens-"true" android:xlargeScreens-"true" android:anyDensity-"true" /> 
«application android:theme-"8style/UnityThemeSelector" android:icon-"8drawable/app icon" android:label-"G8string/app name" android:isGame-"true" android:banner-"Qdrawable/app 

«activity android:label-"G8string/app name" android:screenOrientation-"fullSensor" android:launchMode-"singleTask" android:configChanges-"mcc |mnc | locale | touchscreen | keyboarc 
«meta-data android:name-"unityplayer.UnityActivity" android:value-"true" /> 
«/activity» 
«activity android:label-"G8string/app name" android:screenOrientation-"fullSensor" android:configChanges-"mcc |mnc|1locale|touchscreen|keyboard|keyboardHidden|navigation|orie 
«intent-filter» i 
«action android:name-"android.intent.action.MAIN" /» 
«category android:name-"android.intent.category.LAUNCHER" /» 
«category android:name-"android.intent.category.LEANBACK LAUNCHER" /» 
«/intent-filter» i 
«/activity» 
«/application» 
«uses-sdk android:minSdkVersion-"9" android:targetSdkVersion-"23" /> 
«uses-feature android:glEsVersion-"0x00020000" /» 
«uses-feature android:name-"android.hardware.touchscreen" android:required-"false" /» 
«uses-feature android:name-"android.hardware.touchscreen.multitouch" android: 
required-" false" /» 


«uses-feature android:name-"android.hardware.touchscreen.multitouch.distinct" android:required-"false" /» 
«/manifest» 


在 上 面 的 xml 文 件 中 可 以 看 到 ， 我 们 将 主 Acitivity 和 局 动 界 面 设 置 为 MainMenuActivity， 而 不 是 原本 的 UnityPlayerActivity。 


通过 上 述 步 又， 我 们 可 以 让 App 的 启动 界面 为 Android 原 生 界面 ， 然 后 跳 转 到 Unity 界 面 ， 接 下 来 ， 我 们 再 实现 从 Unity 界 面 跳 转 至 Android 原 生 界 面 的 功能 。 


(4) 在 Unity 中 创建 场景 ， 并 添加 一 个 按钮 。 


(5) 创建 Game.cs 脚 本 ， 并 添加 以 下 代码 : 


using UnityEngine; 
using System.Collections; 
public class Game : MonoBehaviour 


// 点 击 返回 按钮 时 调用 
public void OnBackButtonClick() 
{ 


using (AndroidJavaClass jc = new AndroidJavaClass ("com.unity3d.player.UnityPlayer")) 


using (AndroidJavaCbject jo = jc.GetStatic«AndroidJavaObject» ("currentActivity")) 
{ 


/ Hf] Androiddéft PUnityPlayerActivityfjStartActivity0Zrik 
//stringToEdit 表 示 它 的 参数 
jo.Call("BackToMenu", "msg"); 


(6) 在 UnityPlayerActivity 中 添加 BackToMenu 遂 数 ， 在 该 函数 中 调用 切换 界面 功能 。 


public void BackToMenu (String msg) 

{ 
this.runOnUiThread (new Runnable () 
{ 


public void run () 


// 切 换 到 主 界 面 功 能 
Intent it = new Intent(); 
it.setClass (UnityPlayerActivity.this, MainMenuActivity.class); 
UnityPlayerActivity.this.startActivity (it); 


在 实际 的 软件 开发 中 ， 往 往 会 遇 到 这 样 的 问题 : 在 一 个 用 原生 代码 开发 的 iOS 应 用 中 需要 加 入 AR 的 场景 功能 。 我 们 不 可 能 在 Unity 中 重新 做 一 遍 ， 这 既 没有 必要 也 不 容易 实现 ， 所 以 我 们 要 在 iOS 原 生 代 
码 开发 的 工程 中 调用 Unity 中 制作 好 的 AR 场景 ， 即 实现 Unity 与 iOS 原 生 代码 之 间 的 相互 调用 。 


我 们 需要 在 iOS 原 生 的 工程 中 加 入 一 个 Unity 3D 的 Vuforia 工 程 ， 基 本 的 流程 如 下 : 首先 在 导出 Unity 3D 工 程 中 设置 il2cpp， 支 持 Target iOS Version 8.0， 然 后 根据 从 Unity 3D 导 出 的 Xcode 工 程 ， 设 
置 Native Xcode 工程 ， 接 下 来 将 Unity 的 工程 代码 文件 导入 Native， 最 后 在 main.mm 方 法 中 改变 程序 入 口 ， 来 回 切换 Unity 3D 视 图 和 原生 视图 。 


(1) 在 Native Xcode 工程 中 创建 一 个 Unitylntergration.xcconfig， 以 便 后 面 合 成 的 时 候 使 用 。 


选择 project”s setting， 然 后 选择 info 一 configurations。 


9 © b Wl f unityntegraton ) B xey» 


аяа 8| < 
v È Unityntegration 四 
v firtegratic 
h AppOelegate.h 
m. AppOelegate.m 
hi ViewCoertroser.h 


m ViewCortrodter.m 


[Bj Unityintegration 


PROJECT 


TAROCTS 


Y Deployment Target 


08 Deployment Target 9.3 B 
A Urityinteg'atio 
* Configurations 
"^ Main.uterybeard 
Es Assets xrassets 
LauunchScreen.storyboard 
info ри 
» Supporting Files 
» Products 


ûl 


Unitylntegraton 


Uso  Heleaao 


Y Localizations 


English 一 Development Language 


+ 


O Use Base internationatizaticn 


(2) 去 掉 info.plist 文 件 中 的 Main.storyboard。 


e^o b Ш N Unitylntegration ) 六 Generic iOS Device 


Urstyintegration- Ready | Today ш 18:29 


Build Settings 


efiguration Fla 


1 Configuraton Set 


B for commanc- line builds 


І ESTA LO io 
© unimyintegraton Uniyintegration Ç 
e ass 
A 


2 Files Localized 


UnityIntegration: Ready | Today at 12:18 


EB KE чт 9 BH < > 
v B UnityIntegration Key 
т | Unitylntegration 


D 


w Information Property List 
” Integration Localization native development re... 
Executable file 

Bundle identifier 


InfoDictionary version 


_/] Unitylntegration.xcconfig 
h) AppDelegate.h 
m AppDelegate.m 
h) ViewController.h 
m. ViewController.m 
[P] Assets.xcassets 
| LaunchScreen.storyboard 
=) Info.plist 

b _ | Supporting Files 

b Products 


Bundle name 

Bundle OS Type code 

Bundle versions string, short 
Bundle creator OS Type code 
Bundle version 

Application requires iPhone enviro... 
Launch screen interface file base... 


p Required device capabilities 
p Supported interface orientations 
p Supported interface orientations (i... 


bo db qh qn qn qh qh qh q, q, qh 


D Unityintegration ) |_| Unityintegration ) 


Type 
Dictionary 
String 
String 
String 
String 
String 
String 
String 
String 
String 
Boolean 


String 


Main storyboard file base name $ OQ String 


Info.plist ) No Selection 


Value 

(15 items) 

en 

$(EXECUTABLE NAME) 
$(PRODUCT. BUNDLE, IDENTIFIER) 
6.0 

$(PRODUCT NAME) 
APPL 

1.0 

"7? 

1 

YES 

LaunchScreen 


(1 item) 
(3 items) 
(4 items) 


(3) 在 原生 工程 中 创建 一 个 用 来 放置 Unity 3D 工 程 的 文件 夹 ， 然 后 拖 入 从 Unity 3D 导 出 的 Xcode 工程 到 Native iOS 创 建 的 文件 夹 中 ， 在 导入 的 时 候 确保 是 Classes 和 Libraries 两 个 文件 夹 。 在 导入 的 时 
候 确保 Copy item if needed 是 不 勾 选 的 ， 且 Create group 是 勾 选 的 。 


Unityintegration: Ready | Today at 12:31 


> © B < › B Unityirtegration ) 8 Unityintegratton ) È choose options for adding these files: 
Koy Type [ 
w Informaton Property List 
Localization native development re... 
Executable file 
Rundle identifier 
InfoDictiorary version 
Bundle nane 
Bundle OS Type code 
Bundle versions string, short 
Bundle creator OS Type code 
Bundle version 
Application requires iPhone enviro.. 
Launch screen interface ће base... 
b Required device capabilities $0 


> Supported interface orientatione 


D'ctiorary 
String 
String 
String Create folder references 
Sirin 
mma Add to targets: EJ à unityintegration 
String 
String 
String 
String 
Boolean 
String 
Array al 


Array 


+» 4» t pb 4» 4» 4» ah ahar 


> Supported interface orientations (i... 


Array 


(4) 取消 Classes 的 Native 文 件 中 .h 文 件 的 引用 。 但 是 保留 包含 Vuforia 的 文件 和 你 在 Unity 3D 中 使 用 插件 的 .h 文 件 。 注意， 是 取消 引用 ， 而 不 是 删除 。 


Urutyntegration. Ready Today at 12:53 


Unityintegraton Unitylntegration tegratior 35 tive | Assemb'y-CS^arp ArrayTypesh | No Selection 


Assemb- rrmyTynes.h 
AsseemblyU.. Б524790.һ 
AsserblyU...charatioes.h | // Vuforia.WireframeBehavicur 


WireframeBehaviour t2976175819; 


AssemblyU...4779205.h Do you want to move the 41 selected items to the Trash, or only 


Assemb!yU...ciaratiors.h GF remove the references to them? 


AssermblyU...B350845.h 
AssemblyU...claratiors.h 


Assemb!lyU...2988229.h 


fpragma once 
// Yuforia.WireframeBehavicur[]l 
тучы 2) WireframeBehaviourUSBUSD t2272146858 


As2semblyU...41295007.h 
AecermbiyLi | eiarstione h 
nat ҮРЕ (8) WirefraneBehaviour t2976175819 ж m Items[:]; 
AssemblyU...ctaratiors,.h 
AssemblyU..7349B88.h № WirefraneBehaviour 12976175819 ж GetAt(il2cpp array size t index) ( m Items[index]; ) 
AssemblyU...claratioesh WirefraneBehaviour t2976175819 жж GetAddressAt(il2cpp array size t index) í m Items + index; ) 
A blyU..5638065.h SetAt(il2cpp array size t index, WireframeBehaviour 12976175819 ж value) 

{ 


AssemblyU...claratiors.h m Items[index] = value; 
Assembi/U...2440697.h ! Il2CppCodeGenWriteBarrierim_Items + index, value); 
AssernbiyU. rctaratiors.n ) 
A^ASsStrblyu...5823403.n 
^ssembtyU...ctaratioe s. № 

v AeesenisiyLI...81250862 h 
AssembilyU. cilaratioes.h 
AssembtyU...8042705.h 
AssembilyU...claratiors.h 
AssemblyU...4634907.h 
AssernblyU...claratiors.h 
AssemblyU...81723581.h 
AssembiyU...ciaratioes.h 
Assembtyru...37134735.h 
Assernblyu...clraors. h 
AsacembiyU..494528?.h 

» Aegemhiyl 1. cinratioee h 
AssemblyU...04241735.h 
AssemblyU...claratiors.h 
AssemblyU...14267787.h 
AssemblyU...ciaratioe s. h 
AssemblyU..3029913.h 
AssemblyU...ciaratiors,h 
AssemblyU...2773633.h 


Assernblyu...ctaratiors.n 


oO 


(5) 取消 Libraries 文 件 中 libil2cpp 文 件 的 引用 ， 注 意 不 是 删除 。 


(6) 将 Unity 3D 中 的 Data 文 件 和 QCAR 拖 入 Native iOS 工 程 。 并 且 注 意 Copy item if needed 是 不 勾 选 的 ， 且 Create folder references 是 勾 选 的 。 


EJ] t © / С == |8) Unityintagration Unitylntegratior > m ViewConrtrolierm | No Selection 


v [5j UnityIntegration // 
v |Z) Unityintegration 2 // WMiewController.m 


: 3 // UnityIntegration 
v Integration Wy. 


> _ Classes // Created by Volodya Karpliuk on 5/24/16. 
w Libraries 6 // Copyright © 2016 Volodya Karpliuk. All rights reserved. 


ce ll2ZCppOptions.cpp // 


#import 
libiPhone-lib.a 
Plugins | ViewController () 
о. RegisterFeatures.cop z 
^ RegisterFeatures.h E 3 Г Do you want to move the 328 selected items to the Trash, or 
= RegisterMoroModules.cpp T ViewController : only remove the references to them? 
h RegisterMoroModules.h | 4 
|| UrityIntegration.xccornfig 
ih) AppDelegate.h 
m, AppDalagatc.m 
ih) ViewController.h : : : 
У GONE 3 )didReceiveMemoryWarning 1 
Ë= 23 didReceiveMemoryWarning]; 
// Dispose of any resources that can be recreated. 


)viewDidLoad { 
[ viewDidLoad]: 
// Do any additional setup after loading th 


fe Move to Trash 


h Assets.xcassets 
LaunchScreen.storyboard 
| | Into piist 
Sunporting Files 
Products 


A, Un tyintegration Po Genoric iOS Device UrstyIntegration: Ready Today at 13:22 


tyintegration /integratio 
Un'tyintegrat:c Untyimegraton т Choose options for adding these files: 


/ f 

// MiewController.m 

fi 
3 // UnityIntegration Destination; Copy items if needed 
р // 

// Created by Volodya Karpliuk on 
& // Copyright € 2816 Volodya Karpli Create folder references 

ff 


Added folders: Create groups 


Add to targets: k UnityIntegration 
) #import 


ViewController () 


ViewController 


( )viewDidLoad 4 
viewDidLoad]; 
// Do any additional setup after 


( )didReceiveMemoryWarning í 
[ didReceiveMemoryWarning]: 
// Dispose of any resources that 


— Unitylntegration 
UnityIntegration 
b Frameworks 


w Integration 


w Classes 
h CrashReporter.h 
m CrashReporter.mm 


h iPhone Sensors.h 


m iPhone Sensors.mm 


m main.mm 


| Native 
h PLCrashReporter.h 


(7) 加 入 引用 的 类 库 文件 ， 如 下 图 。 


(8) 如 果 在 Native 工 程 中 创建 了 pch 文 件 ， 请 把 这 个 pch 文 件 删 掉 ， 并 且 把 Native 中 的 pch 文 件 引 用 内 容 拷 入 Unity 3D 生 成 的 pch 文 件 中 。 


Linked Frameworks and Librarina 


Name 


m Security.framework 
=] BAssetrsLibrary.Tframeweork 
lipicanv.2.tod 


E UlKit framework 


E System Configuration. framework 


QuartzCore framework 
mm DOpentx FS framework 
= OpenAL iramework 

= MadiaPlayer.fram eork 
iAd framework 
Foundation- framework 
Corevideo.frarmewar < 
jx CoreMotion.framework 
[es CoreMecia.framework 
Ea CoreLocation. framework 
E CoreGraphics framework 
CFHetwork.framework 
AVFoundntion.iramewerk 
&udiaTaolbox.frame work 


= CoreText framework 


国 libyuroria.a 


ГУ lipiPhone-lb.a 
= liovutoriaUnityPlayer.a 
X 


Status 

Required $ 
Required 77 
Required ү, 
Required £ 
Required 4^ 
Required 2% 
Required 7 
Required z 
Required z 
Required 2% 
Required 77 
Required 77 
Required ^ 
Required 4 
Required 4 
Required ^ 
Required 2% 
Required 2 
Required % 
Required у; 
Required ү; 
Required => 


Required ^ 


Ё1+пПе{ PrefixHeader pch 
Bdefine PrefixHeader pch 


HlTdeF _ OBJE ` 

Bimport zFoundation/Foundation.h* 
Eimport zUIKIL/UIKAiLt.h» 

tendit 


Binclude "Preprocessor. h" 
Hinclude "unltyTrampolineconflgure,hn” 
#include "unityInmntertTace.h" 


Hifndef _ OBJC ` 

Hif USE IL2CPP PCH 
tfanclude "il?cpp precompiled header.h" 
Hendi? 


BendiTr 

#itndef TARGET IPHONE SIMULATOR 
Bidefine TARGET IPHONE SIMULATOR B 
Hendlt 


#detine printt console print 


tendit 


在 Buildsetting 下 的 Apple LLVM7.1-Language 中 设置 Prefix Header 的 pch 文 件 引用 路 径 。 


e^o b» ш 从 Urityntegratian ) 六 Generic OS Device Urityintegration: Ready | Today at 15:23 
sa Q À © E > m BB < )| 国 Unityntecration 


v È Unityhtegration П Genera! Capaoilities Resource Tags Build Settings 
` Unityintegration | 
ост е EB з | + 


ге j 
| tegration В Unityimegration 


» il Osta | TAROETS 

~ Cances | А Untyireeoration 

а Libraries Asset Pack Manifest URL Profix 
Unitylntegraton.:oconfig 

h AppDelegato.h Y Build Locations 

m ^ppDeiegate m yatt ng E Urityirtegratio^ 

hi ViewCor£roller.h 

m ViewCortroller.m 

ВЫ Assets.xcassats 

2 Y Build Options 

7 Laurch Screen. story boerc jetting UN rityirtegratio 
ho.piist 


Precompiled Headers Cache Path lvarjfciders/. b'icOns]7xdti»gy.2y00633r0090gp»/C/com apple.DevoloperToo!/7.3.1 -7D1014/Xcode/SharecPrecomoilecHeeders 


Precompiled Header Uses Fies From Buld Directory Yes © 


b ^ (Supporting Fles 


h PrefixHoaderpch 
> © Products Y Packaging | 


Setting ^ Urityirtegratio^ 
Executable Ргеѓх 
info. plist Preprooessor Profi File 


Y Vereiening 
Gererated Versioning Variables 
Versioning Name Prefix 


[7 Apple LLVM 71 - language | 


Setting 


Increase Sharing of Precompiled Headers 
Precompile Prefx Header 
b Prefix lander 


Recognize Built-in Functions 


Y Apple ЦУМ 741 - Preprocessing 


Catina 
i" 


Preprocessor Macros Not Used in Precompiled Headers 


(9) 把 main.m 文 件 后 缀 改 为 .mm， 把 AppDelegate.m 的 后 缀 改 为 .mm， 并 且 在 Bulid Phases 中 去 掉 Classes 中 的 一 个 main.mm。 


® @ » iud UN Unityintegraton P a Generic iOS Device Urnitylntegration: Ready | Today at 15:40 


E Kz Q д o > | lŠ) UnityIntegration )| | UnityIntegration ) m) ApoDelegate.mm ) No Selection 


Y 5 Unityintegratiorn 
AppDelegate.m 


v UnityIntegration z ! 
s UnityIntegration 


b Frameworks 
b Integration Created by Volodya Karpliuk on 5/24/16. 
/| UnityIntegration.xcconfig Copyright © 2016 Volodya Karpliuk. All rights reserved. 
h. AppDelegate.h 
ЫШ) AppDelegate.mm | AppDelegate.mm #import "AppDelegate.! 
5 ViewControiler.m i AppDelegate () 
M] Assets.xcassets 
È | LaunchScreen.storyboard 


С Info.plist i AppDelegate 


w Supporting Files 
im, main. 
Шона — (800! )арр1іса+іоп: (UlApplication ж)арр1ісаёіоп didFinishLaunchingWithOptions:(NSDictionary x*)launchOptions í 


п) PrefixHeader.pch // Override point for customization after application launch. 


b Products 


} 


~ (void)applicationWillResignActive:(UIApplication x)application í 
// Sent when the application is about to move from active to inactive state. This can occur for certain tvpes of tt 


A Uritylntegration ^5 Generic iOS Device Untyintegration: Ready | Today at 15:53 
< [jj Unityintogration 


Y 2 Urnityintegration Capabilities Resource Tags Build Settngs 
Y Untymntegration 
LI Frameworks 


гро ист 
т Into gr ation M ron 
Data TARGETS 


А Unityintegration 


Y Compile Sources (2 of 90 items) 
B 


D man mm Lin..4 LI Downleads/UnitysVufariaGkhubTest/os/Classes 


m manmi 


+E] 


Remove items 


(10) 把 Classesmain.mm 中 的 代码 文件 全 部 拷 入 Native 中 的 main.mm。 


然后 修改 代码 ， 把 const char*AppControllerClassName- "UnityAppController" 修改 为 const char*AppControllerClassName= "AppDelegate" , 


(11) 在 UnityAppController.h 中 修改 代码 ， 把 


inline UnityAppController* GetAppController () 


{ 
return (UnityAppController*) [UIApplication sharedA2pplication].delegate; 
} 
修改 为 


NS INLINE UnityAppController* GetAppController () 


NSObject«UlApplicationDelegate»* delegate = [UIApplication sharedApplication].delegate; 


UnityAppController* currentUnityController = 


return currentUnit 


yController; 


(UnityAppController *) [delegate valueForKey:QG"unityController"]; 


(12) 在 UnityAppController.mm 文 件 中 修改 代码 ， 导 入 #import "AppDelegate.h" , 把 


- (void)shouldAttachRenderDelegate(] 


- (void)shouldAttachRenderDelegate { 


AppDelegate *delegate - (AppDelegate *)[U 
[delegate shouldAttachRenderDelegate]; 


IApplication sharedApplication].delegate; 


(13) 首先 创建 一 个 ViewController.h， 然 后 在 ViewController.m 文 件 中 加 入 下 面 的 代码 : 


#import "AppDelegate.h 
@property (nonatomic, 
- (void)viewDidLoad { 
[super viewDidLoad 


strong) UIButton *showUnityButton; 


IE: 


self.showUnityB 


con . center 


self.view.backgroundColor = [UIColor blueColor]; 
self.showUnityButton = [UIButton buttonWithType:UI 
[self.showUnityButton setTitle:G"SHOW UNITY" 
self.showUnityButton.frame CGRectMake (0, 0, 100, 44); 


self.view.center; 


iew:self.showUnityButton]; 


u 
u 

[self.view addSu 
F B 


bv 
[self.showUnityBu 


- (void)showUnityButton: (UlButton *) 


[(AppDelegate *)[U 


sender 


ton addTarget:self action:G8selector (showUnityButton:) 


{ 


ButtonTypeSystem]; 
forState:UIControlStateNormal]; 


IApplication sharedApplication].delegate showUnityWindow]; 


(14) 我 们 来 显示 Unity 界 面 和 原生 界面 的 来 回 跳 转 ， 在 AppDelegate.h 中 加 入 


@property (strong, 
@ргорегіу (strong, 
@ргорегіу (strong, 


nonatomic) U 
nonatomic) U 
nonatomic) U 


- (void)showUnityWindow; 
- (void)hideUnityWindow; 
- (void)shouldAttachRenderDelegate; 


[Window *window; 
[Window *unityWindow; 
nityAppController *unityController; 


ForControlEvents:UIControlEventTouchUpl 


(15) 在 AppDelegate.mm 文 件 中 导入 #import "ViewController.h" #I#import "VuforiaRenderDelegate.h" ， 添 加 一 个 导航 控制 器 和 属性 。 


Gproperty (nonatomic, 


extern "C" void VuforiaRenderEvent (int marker 


strong) UlNavigationController *navVC; 


р 


随后 在 didFinishLaunchingWithOptions 中 加 入 代码 : 


- (BOOL)application: (U 


[Application *)application didFinishLaunchingWithOptions: (NSDictionary *)launchOptions { 


ler alloc] initWithNibName:nil bundle:nil]; 
nitWithRootViewController:viewController]; 


self.window = [[UIWindow alloc] initWithFrame: [UIScreen mainScreen].bounds]; 
self.window.backgroundColor = [UIColor redColor]; 

ViewController *viewController = [[ViewContro] 

self.navVC = [[UINavigationController alloc] i 
self.window.rootViewController = self.navVC; 

self.unityController = [[UnityAppController alloc] init]; 


[self.unityContro] 


ler application:application didFinishLaunchingWithOptions:launchOptions]; 


[self.window makeKeyAndVisible]; 


return YES; 


к 


实现 隐藏 和 显示 的 方法 : 


- (UIWindow *)unityWindow í 
return UnityGetMainWindow(); 


} 
- (void)showUnityWindow í 


[self.unityWindow makeKeyAndVisible]; 
UIButton *back = [UIButton buttonWithType 
back.backgroundColor = [UIColor yellowColor]; 


:UIButtonTypeSystem]; 


[back setTitle:Q "BACK" 


back.frame - CGRectMake(0, 0, 100, 


44); 


back.center = sel 


.unityWindow.center; 


— (void 


— 


[self.unityWindow addSubview:back]; 
[back addTarget:self action:8selector (hideUnityWindow) 


forState:UIControlStateNormal]; 


hideUnityWindow { 
[self.window makeKeyAndaVisible]; 


&&5shouldAttachRenderDelegate: 


- (void)shouldAttachRenderDelegate ( 


self.unityController.renderDelegate - 


UnityRegisterRenderingPlugin (NULL, 


&Vufor 


[ [Vui 


forControlEvents:UlControlEventTouchUpInside]; 


iaRenderEvent); 


dif UNITY VERSION»434 


UnityRegisterRenderingPlugin (NULL, 


&Vufor 


iaRenderEvent); 


最 后 重 写 以 下 状态 的 方法 : 


- (void)applicationWil] 


// Sent when the application is about 


// Use this method 
[self.unityContro] 


С to move 
to pause ongoing tasks, disable timers, and throttle down OpenGL ES 
er applicationWillResignActive:application]; 


c. 


- (void)applicationDidi 
// Use this method 


to release shared reso 


// If your application supports background execution, this method is called instead ol 


[self.unityContro 


- (void)applicationWillE 


ler applicationDidEnterl 


) LH 
a) 


Background:applica 


terForeground: (UIApplication *)applica 


// Called as part of 


the transition from 


the background to 


[self.unityContro] 


(void)applicationDidl 


ForiaRenderDelegate alloc] init]; 


ResignActive: (UIApplication *)application ( 


EnterBackground: (UIApplication *) application { 
urces, save user data, invalidate timers, and store enough application state iní 


from active to inactive state. This can occur for certain types of temporary interruptions 


(such as an incoming phone call or 


frame rates. Games should use this method to pause the game. 


Formation 


F applicationWillTerminate: when the user qui 


tion]; 


tion í 


1 the inactive state; here you can undo many ol 
ler applicationWillEnterForeground:application]; 


BecomeActive: (UIApplication *) application í 
// Restart any tasks that were paused (or not yet started) while the application was inactive. 


to restore your application to its current 


CS. 


f the changes made on entering the background. 


If the application was previously in the background, optionally refresh the u 


[self.unityController applicationDidBecomeActive:application]; 


- (void)applicationWillTerminate: (UIApplication *) application { 
// Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:. 
[self.unityController applicationWillTerminate:application]; 


至 此 所 有 的 iOS 和 和 unity 3D AR 场景 的 跳 转 代码 结合 完毕 ， 可 以 运行 了 。 此 后 由 于 版 本 不 同 或 者 设置 不 同 ， 或 许 还 会 磁 到 问题 ， 但 是 不 会 再 出 现 大 问题 了 ， 我 们 可 以 自行 解决 。 
最 后 ， 有 兴趣 的 读者 可 参考 以 下 链接 : 

` https://the-nerd.be/2015/11/13/integrate-unity-5-in-a-native-iOS-app-with-xcode-7/ 

- http://www.makethegame.net/unity/add-unity3d-to-native-iOS-app-with-unity-5-and-vuforia-4-x/ 


° https://github.com/blitzagency/iOS-unity5 


第 10 草 ”使 用 HiAR SDK 开 发 AR 应 用 


10.1 搭建 开发 环境 


要 使 用 HiAR SDK for Unity 进 行 开发 ， 请 安装 下 列 软件 并 进行 相关 配置 。 
1. 下 载 安 装 Unity 
按照 兼容 性 要 求 ， 前 往 官 网 下 载 并 安装 。 同 时 ， 我 们 建议 你 注册 Unity 账 户 ， 以 便于 更 好 地 使 用 Unity 开 发 环境 。 
Unity 下 载 : https:;//store.unity.com/cn, 
2. 下 载 安装 QuickTime (v1.1.x 及 以 后 版 本 无 需 安装 QuickTime) 
由 于 Unity 平 台 限制 ， 在 Windows 系 统 上 ， 需 要 通过 安装 QuickTime 才 能 更 好 地 使 用 HiAR SDK 中 提供 的 视频 AR 功能 。 请 务必 安装 ! 
QuickTime 下 载 : https://support.apple.com/zh-cn/HT201175。 
3. 下 载 安装 Android SDK 和 JDK 
安装 Android SDK 和 JDK 之 后 ，Unity 可 以 导出 Android 工 程 和 应 用 ， 并 支持 直接 在 Android 设 备 上 进行 调试 运行 。 
下 载 Android SDK: https://developer.android.com/studio/index.html hl=zh-cn。 
下 载 JDK: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, 
Uum 
如 果 无 法 正常 下 载 ， 请 尝试 通过 VPN 进 行 访问 。 


完成 开发 环境 的 搭建 后 便 可 以 开始 创建 Unity 工 程 并 导入 SDK。 
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要 使 用 HiAR SDK for Unity 进 行 开 发 ， 请 安装 下 列 软件 并 进行 相关 配置 。 
1. 下 载 安 装 Unity 
按照 兼容 性 要 求 ， 前 往 官 网 下 载 并 安装 。 同 时 ， 我 们 建议 你 注册 Unity 账 户 ， 以 便于 更 好 地 使 用 Unity 开 发 环境 。 
Unity 下 载 : https:;//store.unity.com/cn, 
2. 下 载 安装 QuickTime (v1.1.x 及 以 后 版 本 无 需 安装 QuickTime) 
由 于 Unity 平 台 限制 ， 在 Windows 系 统 上 ， 需 要 通过 安装 QuickTime 才 能 更 好 地 使 用 HiAR SDK 中 提供 的 视频 AR 功能 。 请 务必 安装 ! 
QuickTime 下 载 : https://support.apple.com/zh-cn/HT201175。 
3. 下 载 安装 Android SDK 和 JDK 


安装 Android SDK 和 JDK 之 后 ，Unity 可 以 导出 Android 工 程 和 应 用 ， 并 支持 直接 在 Android 设 备 上 进行 调试 运行 。 
下 载 Android SDK: https://developer.android.com/studio/index.html hl=zh-cn。 


下 载 JDK: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, 


2 注意 
如 果 无 法 正常 下 载 ， 请 尝试 通过 VPN 进 行 访问 。 


完成 开发 环境 的 搭建 后 便 可 以 开始 创建 Unity 工 程 并 导入 SDK。 


10.2 导入 SDK 
下 面 介绍 如 何在 Unity 工 程 中 导入 HiAR SDK for Unity。 在 开始 之 前 ， 请 先 访问 HiAR 官 网 下 载 最 新 版 本 的 SDK。 


1. 下 载 并 解压 SDK 
SDK 的 下 载 链接 为 http://hiar.com.cn/download.html， 前 往 下 载 页 面 下 载 SDK 包 ， 可 以 获得 一 个 zip 文 件 : hiar sdk unity yyyymmdd vx.x.x xxxxxxx.zip (文件 名 随 版 本 更 新 而 变化 ) 。 将 zip 文 件 解 


压 ， 可 看 到 如 下 目录 结构 : 


3rd_party 


ПЯ Ж: 包含 Unity 插 件 文 件 hiar_sdk_unity-x.x.x.unitypackage。 
° doc 目录 : 包含 使 用 说 明文 档 、license.txt 和 changelog.txt。 
. 3td_patty 目 录 : 包含 第 三 方 库 文件 (1.0.6 之 后 的 版 本 有 该 目录 ) o 


2. 新 建 Unity 工 程 


TTE 


运行 Unity 程 序 ， 并 按照 步骤 新 建 一 个 Unity 工 程 。 当 然 ， 也 可 以 直接 打开 已 存在 的 工程 来 进行 导入 工作 。 


Project names 
FirstH ARApp 


Ж 


Locali 


EAdatavtempsFirst HI&ABApp 


Create project 


А г! packages... 


3.& AHiAR SDK for Unity 


双击 hiar sdk_unity-x.x.x.unitypackage 文 件 ，Unity 将 加 载 并 显示 插件 内 容 ， 点 击 Import 开 始 导 入 。 也 可 以 在 Unity 中 点 击 Assets 一 Import Package Custom 
Packagehttp://www.hzcourse.com/resource/readBook?path = /openresources/teach ebook/uncompressed/15940/OEBPS/Text/... 来 导入 插件 。 


Є) Unity Personal - Untitled - First HiARApp - PC, Mac & Linux Standalone «DX11» 
File Edit Assets m Component Window Help 
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£3 Project 
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2 All Models This folder is empty 


G الها‎ Prefabs 
(©. All Scripts 


Importing package 
Маг sdk unity-1.0.9 


v М ii Editor 
Y М iS HIAR 
Y М EEImageTargetTextures 
Y M sample M 
[v]. Г 2Ьа4Ь6Ь0В7ас&769599894содексаб : 
[v] шы d33cScbfed2ce4066de2o1eBeazcu 
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Y [V ES 3DModels 
. |HiAR .controller 
x. šJ HIAR.FBX 
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€«QHiARRobot.unity 
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Y "м Ба Materials 
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[ All ][ None | | Cancel || 


导入 完成 后 可 以 在 Project 窗 口中 看 到 以 下 内 容 。 


es 
File Edit Assets GameObject Єсяпұхэний Mindoan Help 


2 EERE ESOT E E Eem Hes =] 
= ттт | "= pem Є сате Ë Asset Store ке, еса Services TE 
Create " fa A] 8 | Shaded | `D: | | і 

Маіп Camera 

Directional Light 


(C AMI M aterials 

7 АП Models =] HiAR-U “Unity 

2 All Prefabs Î Plugins | 
O All Scripts E StreamingAssets 


^ ui Editor 

Fi HIAR -Unity 

"a Plugins 

Fi StreamingAssets 


~ 注意 
Unity 插 件 与 一 般 意 义 上 的 插件 存在 区 别 ， 每 次 在 新 工程 中 使 用 时 都 需要 重新 进行 导入 。 


至 此 ，SDK 导 入 工作 已 经 完成 ， 可 以 开始 创建 HelloWorld。 


10.3 ”创建 HelloWorld 


本 节 将 介绍 如 何在 Windows 系 统 下 使 用 HiAR SDK 创 建 一 个 简单 的 AR 应 用 。 
1. 创 建 HiARCamera 


在 新 建 的 Unity 工 程 中 会 默认 创建 一 个 Main Camera (如 下 图 ) ， 请 先 将 其 删除 。 


File Edit Assets GameObject Component HIAR Window Help 


0 @ Global 


# Scene ` ÉB Asset Store °$ Animator € Game 
Shaded "| | 20|| © Q) 0” 


> l Pi 


б " = ЧЕ Hierarchy | 
Gizmos * ^ o*& | 


Create * 


Main Camera 
Directional Light 


@ Project . C Console 
Create ”| | 
Fi Favorites Assets » 
^. All Materials 


Ë= Editar 


然后 将 Assets/HiAR-Unity/Prefabs 目 录 下 的 HiARCamera 拖 至 Hierarchy 窗 口 。 


要 使 用 HiAR 平 台 的 功能 ， 必 须 创建 应 用 并 获取 AppKey 和 Secret。 
(1) 首先 创建 应 用 。 前 往 HiAR 进 行 后 台 的 应 用 管理 ， 点 击 “ 新 建 应 用 ”按钮 并 按照 提示 要 求 创建 一 个 新 应 用 。 


(2) 下 面 查看 应 用 信息 。 系 统 会 为 每 个 应 用 分 配 唯一 的 AppKey 和 Secret。 进 入 应 用 管理 界面 ， 可 以 在 列表 中 查看 应 用 对 应 的 AppKey 和 Secret。 


File Edit Assets GameObject Component HIAR Window Help 


D | * Center € Global | 


$E Scene | Asset Store °$ Animator € Game 
Shaded "12р. 5 19) Е 


E EN E Hierarchy | 


Gizmos * v All | | Create ~ 


Directional Light 


£3 Project [] Console 
Create " e 


4 


> 
". Favorites Assets » HIAR-Unity > Prefabs 


All Materials 
- All Prefabs 
All Scripts 
-| All Models 


# CloudR ecognition 二 
__ * Cube P 
> S HIAR Camerá 
| ø ImageTarget 
» TargetDynamic 
# VideoPlayer 
P g xiaoliang, model 


"Assets 
>u Editor 
Y HiAR -Unity 
> ЫЫ 3DModels 


> d bi 


File Edit Assets GameObject Component HIAR Window Help 
ey Er 
# | Ê Asset Store —"$ Animator € Game E " == Hierarchy | 
"| 2DI I 5: |4) 0” Gizmos т. (Orê \ ||| Create 7| ( 
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| HiAR Camera 


£3 Project | E Console 
Create * 
¥; Favorites Assets 上 HiAR-Unity » Prefabs 
АП Materials # CloudRecognition 


portal.hiar.io 


您 已 使 用 0/20 个 应 用 


AppKey/Secret 


Copyright © 2015 HiScene, All Rights Reserved 


Admin A 


您 已 使 用 1/20 个 应 用 


创建 日 期 


AppKey/Secret 
2015-11-24 22:02:47 


RrjF2pB6nN / 57eca32b785156. 


Copyright B 2015 HiScene, All Rights Reserved 


在 Hierarchy 窗 口中 选中 HiARCamera， 在 其 对 应 的 Inspector 窗 口中 找到 AppKey 和 Secret 选 项 ， 并 填写 信息 。 


\ e Inspector 
АЛ Hi&P Camera 
Тад | Untagged —— 


= | = Hierarchy | 

| Create ”| [ 
Directional Light 

€ FESS | 
НАК amsa | Prefab | 


+ | Layer | Default. 


Select —— w ul 


Fa Transform 
Position 
Rotation 
Scale 

¥ |c] i Hi AR Engine Behaviour (Script) 

. Script lw HiáREngineBehaviour 
App Key Your AppKey 
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` Camera Direction. || CAMERA, DEFAULT. 
Mirror Background LJ 
Auto Stait Recognition м 
MultiTerget LI 
Enable Stereo Cameras C 
Center Point Hone (Target) 


Y 0 
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Y 1 


хо 
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X11 


[viai 


Script 


Target Manager Behaviour (Script) 
lw Target ansgerBehasiour 


„Add Component — 


如 果 没有 指定 正确 的 AppKey 和 Sectet， 应 用 可 能 无 法 正常 运行 。 


(1) 首先 添加 ImageTarget， 将 Assets/HiAR-Unity/Prefabs 目 录 下 的 lmageTarget 拖 至 Hierarchy 窗 口 。 


(2) 下 面 设置 识别 图 片 ， 在 Hierarchy 窗 口中 选中 ImageTarget， 在 其 对 应 的 Inspector 窗 口中 找到 HiAR Target Mono Behaviour (Script) ， 在 Data Set 选 项 中 选择 sample。 此 时 ， 编 辑 窗口 中 将 显 
70—90 "苹果 ”的 图 片 ， 这 是 刚刚 设置 的 识别 图 片 。 


sample 是 SDK 中 内 置 的 本 地 识别 包 ， 
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et Store °$ Animator Є Game 


包含 两 张 识别 图 片 ， 你 可 以 在 Image Target 选 项 中 进行 选择 。 
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4.AR 制 作 与 运行 


(1) 在 Hierarchy 窗 口中 选中 ImageTarget， 右 击 并 在 弹出 的 菜单 中 选择 3D Object 一 Cube， 识 别 图 片上 将 显示 一 个 立方 体 模 型 。 这 个 模型 就 是 在 识别 图 片上 晋 加 的 AR 内 容 ， 可 以 适当 调整 模型 的 大 
小 以 便 查 看 。 
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(2) 上 述 操作 完成 后 ， 需 要 在 Unity 环 境 下 运行 以 查看 效果 。 在 运行 之 前 ， 请 确保 电脑 已 安装 了 摄像 头 。 


点 击 运 行 按钮 ， 摄 像 头 将 启动 并 采集 画面 ;将 摄像 头 对 准 “ 苹 果 ” 图 片 ， 识 别 成 功 后 将 在 图 片上 区 加 显示 一 个 立方 体 模型 。 
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至 此 ， 你 已 成 功 创建 了 一 个 简易 的 AR 应 用 ， 可 以 继续 制作 更 多 AR 效果 ， 或 者 将 当前 工程 生成 Android 和 iOs 应 用 。 


10.4 导出 Android 工 程 


1. 设 置 Android SDK 和 JDK 路 径 


在 Unity 中 ， 点 击 Edit 一 Preferenceshttp://www.hzcourse.comy/resource/readBook?path=/openresources/teach_ ebook/uncompressed/15940/OEBPS/Text/...， 在 弹出 的 Unity Preferences 对 
话 框 中 点 击 External Tools 选 项 ， 将 Android SDK 和 JDK 路 径 分 别 设 置 为 已 安装 SDK 的 根 目录 。 
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在 Unity 中 ， 点 击 File 一 Build Settingshttp://www.hzcourse.com/resource/readBook?path-z /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., frsgtHBSBuild Settings 对 话 


框 中 选择 Android 平 台 ， 并 点 击 Switch Platform, ка: Ада Current 将 当前 工程 添加 到 Scene In Build 窗 口中 〈 请 确保 已 被 勾 选 ) 。 
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3. 应 用 设置 


{Build Settings 对 话 框 中 点 击 Player Settingshttp://www.hzcourse.com/resource/readBook?pathz /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., Œlnspectorð O 
找到 Settings for Android， 点 击 Resolution and Presentation 选 项 ， 将 Default Orientation 设 置 为 Landscape Left, 


@ + L 
Settings for Android 
Resolution and Presentation 


Orientation 


Default Orientation" | Landscape Left 


Status Bar 
Status Bar Hidden ivi 


Use 32-bit Display Buffer" 
Disable Depth and Stencil| | 
Show Loading Indicator | Don't Show 


* Shared setting betveen multiple platforms. 
Icon 

Splash Image 

Other Settings 


Publishing Settings 


л: 


生成 的 Andtoid 应 用 暂时 不 支持 Auto Rotation， 另 外 ， 有 的 手机 由 于 自身 系统 原因 不 支持 Porttait Upside Down Ao 


点 击 Other Settings 选 项 ， 取 消 勾 选 Auto Graphics AP1， 然 后 在 Graphics APls 处 删除 多 余 选 项 ， 仪 保留 OpenGLES2。 


ГЫ 


"n 


Other Settings 


Rendering 

Rendering Path* 

Auto Graphics API 
x Graphics APIs 


Dynamic Batching 
GPU Skinning* 


Virtual Reality Supported 


Identification 
Bundle Identifier 
Version* 

Bundle Version Code 
Minimum API Level 


3k 


| Forward 


= 
= 
LJ 


= 


 com.hiscene.roboto || 
1.0 | 
p si 


| Android 4,0 'Ice Cream Sandwi Я! 


然后 ， 在 Bundle Identifier 中 填写 应 用 的 apk 包 名 ， 并 将 Minimum АРІ Level 设 置 为 Android 4.0 或 更 高 版 本 。 


Other Settings 
Rendering 
Rendering Path* 
Auto Graphics API 
Graphics APIs 

一 DOpencLEsZ 


Forward 


uL 


Multithreaded Renderina* | | 


Static Batching 
Dynamic Batching 
GPU Skinnina* 


Virtual Reality Supported | | 


Identification 
Bundle Identifier 
Version” 

Bundle Version Code 


Minimum API Level 
Configuration 


4. 生 成 Android 应 用 


com.hiscene.hirar.hellol 


1.0 
1 
Android 4,0 Ice Cream Sandwi $ 


完成 上 述 操作 后 ， 在 Build Settings 对 话 框 中 点 击 Build， 保 存 apk 并 开始 生成 应 用 。 在 此 过 程 中 ， 可 能 会 要 求 你 更 新 Android SDK 和 JDK， 请 按照 提示 进行 更 新 。 


Build Settings " e — 


helloworld.unity 


[ Google Android Project] 
Development Build m 
AutoconnectProfiler | | 
Script Debuaging m 


| Build And Run. 


| Switch Platform | [Player Settings... 


导出 成 功 后 可 以 看 到 apk 文 件 。 


m 5 修改 日 期 
"a Ы Assets 2015/11/11 16:28 
E =E ıJ Library 2015/11/11 16:50 
a 最 诉 访 问 的 以 办 do PrejectSettngs 2015/11/11 16:49 


[| | | EE 


E 2015/11/11 16:50 
= E A 


BE 视频 

ы] 图 片 

xrEs 

中 音乐 
m 计算 机 

E Windows (CJ 

ca 文件 存储 (02 
E 网 阁 


hello.apk #0089: 2015/11/11 16:50 创建 日 期: 2015/11/11 16:50 
| АРК 文件 文 小 : 24.4 MB 


5. 导 出 Android 工 程 


如 果 希 望 将 当前 工程 导出 为 Android 工 程 文件 ， 则 需要 在 第 4 步 中 勾 选 Build Settings 对 话 框 中 的 Google Android Project， 然 后 点 击 Export。 


Building Player 


| mnressinn. | Don't override 
Google Android Project] —— 
Development Build 
Autoconnect Profiler | 


Android | а Script Debugging |. 
Tizen 
] Windows Store 


Windows Phone 8 


witch Platform || Player Settings... 1 Export. j| Build And Run 


m— mcm rome = =- 


== 


导出 的 工程 文件 如 下 图 所 示 。 


“= 


p * har. > Маг... » | 4. چ‎ hiarproject p 


= AndroidManifest.xml 


| | project.properties 


10.5 ”导出 iOS 工 程 


在 开始 之 前 ， 请 务必 先 保存 工程 。 由 于 Unity 无 法 直接 生成 ipa 文 件 ， 因 此 需要 先导 出 iOS 工 程 文件 ， 然 后 通过 Xcode 编译 生成 。 
1. 选 择 平台 


在 Unity 中 ， 点 击 File 一 Build Settingshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...， 在 弹出 的 Build Settings 对 话 
框 中 选择 iOS 平 台 ， 并 点 击 Switch Platform， 点 击 Add Current 将 当前 工程 添加 到 Scene In Build 窗 口中 (请 确认 已 勾 选 ) 。 


IM helloworld.unity 


‚ [| Add Current | 


| Platform 


Run in Xcode as | Release $ | 
Development Build [| 
Autoconnect Profiler — | | 
Script Debugaing m 


(Build ^ J| Build And Run | 


2.iOS 应 用 设置 


{Build Settings 对 话 框 中 点 击 Player Settingshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...， 在 Inspector 窗 口中 
找到 Settings for iOS, RJ Resolution and Presentation 选 项 ， 将 Default Orientation 设 置 为 Landscape Left, 


ГИК | 0 | # | 
| Settings for IOS 


Resolution and Presentation 


Orientation 
Default Orientation* | Landscape Left 


Status Bar 
|| Status Bar Hidden V 
Status Bar Style Default 


Disable Depth and Stencil 
Show Loading Indicator | Don't Show 


* Shared setting betveen multiple platforms. 


Icon 


Splash Image 
Debugging and crash reporting 


| Other Settings 


Ф. 
ЛЕР: 


生成 的 OS 应 用 暂时 不 支持 Auto Rotation 。 


点 击 Other Settings 选 项 ， 在 Bundle Identifier 中 填写 应 用 的 Bundle ID, 


Other Settings 


Rendering 

Rendering Path* Forward T 
Auto Graphics API (w 

Static Batching м 

Dynamic Batching v 

GPU Skinning* 图 

Identification 

Bundle Identifier *Your Bundle ID* 
Version” 1.0 

Build 0 

Configuration 

scripting Backend IL2CPP ; 
Target Device | iPhone * iPad m^ 
Target Resolution Native (default device resol: 
Target SDK Device SDK x 
Target minimum 105 Vers 6.0 : 


Use on demand resources, | 
Accelerometer Frequency | 60 Hz - 


Location Usage Descriptio 


点 击 Other Settings 选 项 ， 取 消 勾 选 Auto Graphics AP1， 然 后 在 Graphics APls 处 删除 多 余 选 项 ， 仪 保留 OpenGLES2。 


Resolution and Presentation 
Icon 


Splash Image 


Debugging and crash reporting 


Other Settings 
Rendering 
Rendering Path* Forward 
Auto Graphics API 
Graphics APIs 
= OpenGLES2 


Static Batching 
Dynamic Batching 
GPU Skinning" 


同时 ， 确 保 Strip Engine Code* “没有 ”选中 。 


.AOT Compilation Options 
Strip Engine Code* 


3. 导 出 iOS 工 程 


完成 上 述 操作 后 ， 在 Build Settings 对 话 框 中 点 击 Build， 选 择 目录 并 开始 导出 iOS 工 程 。 


Build Settings "- e | 


Scenes In Build 
helloworld.unity 


cui ATCO TUÊ ds 
Development Build 
Autoconnect Profiler 
Script Debugging 


Windows Phone 8 


| Switch Platform || Player Settings... ` [Lh Build | Build And Run | 


导出 成 功 后 会 得 到 iOS 工 程 文件 ， 可 以 通过 Xcode 进行 编译 来 生成 iOS 应 用 。 


- 


« hiscene + 我 的 文档 » HelloWorld + hello ios project + 


ta le w 


£L Windows (C:) 
cs 文件 存储 (0:) 


бы 网 阁 


| 18 个 对 象 


10.6 ”使 用 本 地 识别 包 


HEC ШИБЕ 
= Й 


Ë build 

|; Classes 

Ë Data 

Ь Libraries 

j| Temp 

|: UnityData.xcassets 

ıl Unity-iPhone 

| Unity-iPhone Tests 

L Unity-iPhone.xcodepro] 

| « build 

| | Info.plist 

Wi LaunchScreen-iPad 

| LaunchScreen-iPad.xib 

| | LaunchScreen-iPhone.xib 

IR LaunchScreen-iPhoneLandscape 
B LaunchScreen-iPhonePortrait 
В MapFileParser.sh 

- postprocess 


本 节 将 介绍 如 何在 Unity 工 程 中 使 用 本 地 识别 包 。 


1. 下 载 本 地 识别 包 


2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/11/11 17:06 
2015/9/22 0:07 
2015/11/11 17:06 
2015/9/21 8:34 
2015/9/21 13:22 
2015/9/21 13:22 
2015/9/21 8:34 
2015/9/21 8:34 
2015/9/21 10:22 


күй е SE 
к 
XD 
= 
хон 
THE 
= 
Xem 
wi 
BUILD XÈ 
PLIST HF 
PNG Ee 
XIB 文件 
XIB 7 
PNG ES 
PNG 8% 
SH 文件 


2015/11/11 17:06 文本 文档 


前 往 HiAR 管 理 后 台 ， 上 传 需要 识别 的 图 片 并 下 载 识 别 包 ， 可 以 获得 一 个 unitypackage 文 件 (本 例 中 以 mydata.unitypackage 为 例 ) 。 


2. 导 入 本 地 识别 包 


双击 mydata.unitypackage 文 件 ，Unity 加 载 并 显示 包 内 容 ， 点 击 Import 开 始 导入 。 


==} L=) ws 


Importing package Ed 
mydata 


v М i Editor 
Y [V] SSHIAR 
Y SS ImaqgeTarqgetTextures 
Y шш mydata NEW 
= imi ?44951678B61f3efbca0736c5a794937 
МЇ imi e438ab8d5d36d3762481223dd341:::5 
ваті СА авія 
i HiAR 
i| |mydata.xml 
Y lM 5 mydata 
[J | |74495167861f3efbca0736c5a7949ca1::i 
[V | |e438ab8d5d36d3762481223dd34161tizilt 


Y М = 
Y iM 


All |[ None | Cancel || Import 


导入 完成 后 ， 可 以 在 Assets/SstreamingAssetSHiAR 目 录 下 看 到 刚才 导入 的 mydata。 


£3 Project О Console а 7 三 
| Create * m Q 41% |ж 
Y7 7 Favorites 2 [Assets > StreamingAssets MAR 
‘All Materials *- mydata 
© All Models 88 sample 


2 All Prefabs "mydata 
— . All Scripts "sample 


ТЫЗ Assets 
pi Editor 
Y 53 HiAR -Unity 
Î audio 
i Example Scenes 
БШ Materials 
i3 Prefabs 
bi Resources Asset Labels 
» Scripts 
P si Plugins 学 
"iS StreamingAssets Y Ы mydata 


3.izg&lmageTarget 


选中 工程 中 使 用 的 ImageTarget， 在 其 对 应 的 Inspector 窗 口中 找到 HiAR Target (Script) ， 在 Data Set 选 项 中 选择 mydata， 然 后 在 Image Target 选 项 中 选择 需要 的 识别 图 片 。 


€ Unity Personal - Untitled - hello hiar - PC, Mac & Linux Standalone* «DX11» 
File Edit Assets GameObject Component Window Help 


= Hierarchy = # Scene Ж: 3 ЁЎ Asset Stor = ө Inspector | Services 
Create ”| (a7 All | Shaded ТЕ RJ "|| Gizmos ” | (o7 All ImageTarget [jStatic v ^ 
Directional Light Tag | Untagged + | Layer | Default 
Y HIARCamera Prefab | I 
camera 
ImageTarget 


Select | Revet | Apply 
T~. Transform 

Position хо | 

Rotation хо 

Scale X1 


v i: (Mesh Filter) 
Mesh ш 


т М Mesh Renderer 
Cast Shadows | Off 


Receive Shadows | | 
* Materials 
Use Light Probes 
Reflection Probes | Blend Probes č ¢ 


D Project О Console 


| Create ~ a ———— s. 


A : Anchor Override None (Transform 
Tı Favorites ^ Assets » StreamingAssets + HIAR > - ( ) 


° 
'— All Materials | Б mydata V Hi AR Target (Script ©, 
©All Models Ыш sample Data Set mydata ; 
O. All Prefabs >| mydata Image Target | 74495167861f3efbca07: 


© All Scripts " sample Y| | M Hi AR Object (Script) 


vi Assets Unlit/Texture - 
p aš Editor 
vi HiAR -Unity 
s audio 
i Example Scenes 
& Materials 


4. 调 整 ImageTarget 的 尺寸 


ImageTarget 在 场景 中 的 尺寸 时 常 需要 调整 ， 所 以 我 们 给 ImageTarget 添 加 了 Width 和 Height 两 个 属性 ， 以 方便 这 一 操作 。 


€ Unity Personal - VideoPlayer.unity - 1025атріе01 - PC, Mac & Linux Standalone* <DX11> 
nicis Edit Assets moa Comoe _ Window Help ` 


E E Hierarchy Е -= 
| Create * | (gal АП ) = Shaded 

Directional Light Y E с M Hi AR Target Mono Behaviol.; % 
Y HIARCamera Data Set sample 


camera Image Target | 7d33cScbfe42ce40€* | | 
ImageTarget Width 9 | 
| 


Height TS 5,058548 


Unlit/Texture 
Shader | Unlit/Texture 


由 于 Unity 自 身 导 入 功能 的 设计 问题 ， 当 同一 图 集 重复 导入 两 次 时 ， 第 一 次 导入 内 容 有 效 。 如 果 发 现 第 一 次 导入 存在 问题 ， 请 先 删 除 第 一 次 导入 的 内 容 后 再 导入 正确 的 识别 库 。 


10.7 ”开发 云 识别 应 用 


为 了 解决 识别 图 片 的 数量 限制 ， 以 及 上 线 应 用 不 能 动态 修改 识别 图 片 和 AR 内 容 的 问题 ， 我 们 在 HiAR SDK for Unity 新 版 本 (v1.1.x 及 后 续 版 本 ) 中 集成 了 云 识别 功能 。 本 节 主 要 向 大 家 介绍 如 何 通 过 
НАК SDK for Unity 来 制作 支持 云 识 别 的 AR 应 用 。 


下 面 将 介绍 如 何在 Windows 系 统 下 ， 使 用 HiAR SDK 创 建 一 个 简单 的 支持 云 识 别 的 AR 应 用 。 


1. 创 建 图 集 并 关联 应 用 
图 集 是 HiAR 管 理 平台 提供 的 一 种 识别 图 片 管理 方式 ， 通 过 设置 图 集 与 应 用 关联 ， 可 以 方便 地 管理 应 用 的 云 识别 内 容 。 


(1) 进入 管理 后 台 首 页 ， 在 “图 集 与 识别 图 片 ”模块 处 点 击 “ 查 看 所 有 图 集 ”， 进 入 图 集 管理 界面 。 


рокта! пага 


App 


图 集 与 识别 图 片 统计 分 析 


GRENA, WM AncKey 和 Secret. 管理 AR RF, BEERS. EEEH Тан, ЖЕЕ. 


ASANA 查看 所 有 图 集 


在 图 集 管理 界面 中 ， 点 击 “ 新 建 图 集 ” 按 钮 。 


га! 


您 已 使 用 1/20 个 图 集 


创建 日 期 


2015-11-12 15:30:17 


Copyright @ 2015 HiScene, All Rights Reserved 


在 弹出 的 “新 建 图 集 ” 对 话 框 中 填写 图 集 名 称 ， 点 击 “ 新 建 ” 完 成 图 集 创建 。 


现在 ， 可 以 在 图 集 列表 中 看 到 刚刚 新 建 的 图 集 。 


您 已 使 用 2/20 TAF 


创建 日 期 


2015-11-12 15:30:17 


(2) 关联 应 用 ， 顾 名 思 义 ， 就 是 将 图 集 关 联 到 应 用 ， 只 有 通过 关联 操作 ， 在 应 用 进行 云 识别 的 时 候 ， 该 图 集中 的 图 片 才 会 被 识别 。 


文档 中 心 ” 开 发 者 社区 аю Ô 


REEF 3/20 EE 


图 片 用 量 创建 日 期 


2016-01-28 145208 B 


2016-02-04 11:40:17 


2016-03-17 10:33:57 


2 .新建 Unity 工 程 并 导入 SDK 


运行 Unity 程 序 ， 新 建 一 个 Unity 工 程 ， 然 后 将 SDK 包 中 lib 目 录 下 的 hiar sdk unity-x.x.x.unitypackageX FE AZ Тї, 


先 将 工程 中 默认 创建 的 Main Camera 删 除 ， 再 将 Assets/HiAR-Unity/Prefabs 目 录 下 的 HiARCamera 和 CloudRecognition 拖 至 Hierarchy 窗 口中 ， 同 时 确保 CloudRecognition 的 “Auto Cloud 
Recognition” 处 于 勾 选 状态 。 


-oe 


` Q Unity - testunity - HiARCoudRecognition - PC, Mac & Linux Standalone <DX11> 
File Edit Assets GameObject Component HIAR Window Help 


сарн а! e"Pivot LOCA 


Layout 


ЧЕ Hierarchy -= Ө inspector а= 
Create + V CicudReccgniton Static + 
Directional Light Tag "Untzggudd  —— Layer fi 
HiARCamera Prefab Select Revert Apply 
CloudP.ecognition | 


z x 
| Transform m a. 


~ Vides Position X -0.031470 Y 1.866775 -0.112125 


w 
z 
Rotation z 


у 
тшт 
* 

á` 
Persp 


Add Component 


Project 

Create + 

fs Edito 

853 HIAR -Unity 
8m 3DModels 
5 audio 


88 Example Ecenes 
ëm materi эв 
BS Prefabs 


CloudP ecognition 


B HIARCamera 
Ф ImagcTaract 
Ф [argetDynarie 
Ф videcFlayer 
IN xiasliana mode 
8a Resources 
iim scripts 
$ Plugins 
83 StreamingAssets 


$ test 


š @ HiARTa rgetEditer ; set for naxt time 


"Auto Cloud Recognition” 处 于 选中 状态 表示 应 用 运行 时 会 自动 进行 云 识别 ， 否 则 不 进行 云 识 别 。 


在 Hierarchy 窗 口中 选中 HiARCamera， 在 其 对 应 的 Inspector 窗 口中 找到 AppKey 和 Secret 选 项 ， 并 填写 信息 。 


应 用 名 AppKey/Secret 创建 日 期 
E Е x 
HIARDefence 2016-07-14 09:34:32 : 
в А 


HiARDemo KqMPpFQAZY / 02568108ee340f745957813f72f98d719 2016-04-11 23:28:24 


图 Unity - testunity - HiARCloudRecognition - PC, Mac & Linux Stendalone* «DX11- 
File Edit Assets GameOhject Component HIAR Window Help 


ёа ow SG I "*PNot Local = = Leyers ~| [Layout 


HF Scene € Game $ EN y „= Ө inspector 
5һаде4 ep Ж ), , Gizmos Create V HiaR.Camera 
Directional Light Tag "Untagged Layer 


Select Revert 


HIAR Camere Prefab 


J Transform 
Position 
Rotation 
Scale 
HI AR Engine Behaviour (Script) 
BF Fnginel 
App Kcy nDzzTILOHx 


Darault 


Secret 302553715465529f64ac88c842948cch| 


Camere Direction CAMERA DEFAULT 


Mirror Background 

Auto Start Recognition 
MultiTarget 

Enable Sterea Cameras 


Canter Point Nona (Tarqet| 


We 
= n Target Manager Behaviour (Script) 


AC ® 
Project lx 


Create + A Ф 
85 Editor 
ЁЗ HiAR-Unity 

Bu 3D Models 

% audio 

B8 Example Scenes 


Add Component 


Bm Materials 

Es Prefabs 
Ф CloudPecognition 
Ф нідрсатега 
е ImegeTarget 
Ф TaractDynamic 
Ф VideoPlayer 


Lj 
== 
@ Plugins 


Resources 


Scripts 


Bm StreamingAssets 


$t test 


如 果 没 有 指定 正确 的 AppKey 和 Sectet， 应 用 可 能 无 法 正常 运行 ， 也 不 能 进行 云 识 别 ， 因 为 云 识 别 需 通过 该 AppKey 和 Sectet 与 你 在 HiAR 管 理 后 台 创 建 的 应 用 对 应 ， 以 此 来 确定 识别 图 集 。 


到 这 一 步 ， 应 用 的 功能 都 已 经 实现 完成 ， 与 本 地 识别 应 用 的 区 别 在 于 不 需要 添加 本 地 识别 库 以 及 AR 内 容 ， 如 果 要 导出 Android 程 序 (工程 ) 或 is 工程， 请 参考 其 他 章节 。 


AYI Ута 


本 节 将 介绍 如 何 制 作 并 上 传 AR 内 容 到 HiAR 管 理 后 台 ， 以 达到 云 识别 并 展示 AR 内 容 的 效果 。 


在 开始 制作 之 前 ， 我 们 先 了 解 一 人 HiAR SDK for Unity 云 识别 的 流程 及 原理 。 简 单 说 就 是 先 将 制作 好 的 “AR 内 容 ” 上 传 到 云端 ， 并 与 入 库 的 “识别 图 片 ”相关 联 ，“ 应 用 端 ” 通 


出 对 应 的 “识别 图 片 ”后 ， 下 载 相关 联 的 “AR 内 容 ” 并 在 “应 用 端 ” 进 行 展 示 。 


(1) 首先 创建 Unity 工 程 并 导入 SDK， 这 一 步骤 与 本 地 识别 应 用 的 制作 过 程 完 全 一 样 ， 只 是 目的 不 一 样 ， 在 这 里 只 是 为 了 制作 内 容 ， 而 不 是 制作 应 用 。 


(2) 将 新 增 的 需要 识别 的 图 片上 传 到 HiAR 管 理 后 台 ， 发 布 成 功 后 下 载 包含 该 识别 图 片 的 识别 包 ， 并 将 其 导入 新 建 的 工程 ， 制 作对 应 的 AR 内 容 。 


AR 内 容 包 是 Unity AssetBundle 的 zip 压 缩 包 ，HiAR SDK for Unity 通 过 云 识别 后 可 将 该 识别 包 在 运行 时 加 载 显 示 。 关 于 AssetBundle 的 概念 及 内 容 请 参考 Unity 的 官方 说 明 。 


以 云 识 别 一 幅 图 片 并 显示 Cube 模 型 为 例 ， 先 创建 ImageTarge 到 Hierarchy 目 录 下 ， 并 设 定好 识别 图 片 ， 在 该 ImageTarget 下 创建 一 个 Cube。 


过 “ 云 识别 服务 ” 


识别 


< Очу - testunity - HARCoud 
Fille Edit Assets 


e HP [argetEditor : set tor next tme 


然后 ， 将 Cube 拖 到 Prefabs 目 录 下 ， 选 中 Prefabs 中 的 Cube 后 ， 在 Inspector 窗 口中 设置 AssetBundle 名 为 cube 及 扩展 名 为 unity3d。 此 处 的 AssetBundle 名 可 以 根据 实际 情况 命名 ， 但 扩展 名 必须 为 


unity3d, 


最 后 选择 菜单 HiAR 一 Build AssetBundles 一 AllI 项 ， 生 成 AR 内 容 包 。 刷 新 Asset 目 录 后 ， 可 以 看 到 在 该 目录 下 生成 了 AssetBundles 子 目录 ， 该 子 目录 下 有 Android、iOS、Windows 和 Mac 四 个 子 目录 ， 


分 别 存放 不 同 平台 的 AR 内 容 包 。 


7 注意 : 
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Unity 针 对 不 同 的 平台 有 不 同 的 AssetBundle 文 件 格 式 ， 所 以 如 果 要 支持 多 平台 ， 必 须 为 每 个 平台 都 生成 对 应 的 AssetBundle。 
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从 1.2.0 版 本 开始 ， 只 需要 把 要 显示 的 模型 做 成 assetbundle 并 上 传 就 可 以 了 。 
3. 上 传 AR 内 容 包 


准备 好 了 AR 内 容 包 ， 我 们 需要 将 其 上 传 到 HiAR 管 理 后 台 。 登 录 管理 后 台 后 ， 找 到 对 应 的 识别 图 片 ， 查 看 其 详情 。 


在 详情 页 的 下 方 有 “设置 Unity AR 内 容 包 ” 一 栏 ， 下 面 分 别 有 Android、iOS、Windows 和 Mac 四 项 ， 分 别 代表 四 个 平台 。 点 击 每 项 右边 的 “设置 ”按钮 ， 将 刚 生 成 的 AssetBundles 目 录 下 对 应 平台 
录 下 的 .zip 文 件 进行 上 传 。 
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制作 和 上 传 AR 内 容 包 可 以 根据 实际 应 用 情况 只 选择 需要 的 平台 ， 并 不 是 每 次 都 需要 在 所 有 平台 上 生成 或 上 传 。 
4. 应 用 自 测 


为 了 确保 新 上 线 的 内 容 可 以 正常 工作 ， 可 以 通过 已 上 线 的 对 应 应 用 直接 识别 图 片 以 测试 效果 。 


10.9 ”创建 视频 AR 应 用 


可 以 将 视频 作为 AR 内 容 ， 妓 加 到 图 片上 并 进行 播放 。 
1. 基 础 开发 及 设置 

先 完成 以 下 工作 : 

(1) 新 建 Unity 工 程 并 导入 SDK。 

(2) 创建 HiARCamera。 

(3) 设置 AppKey 和 Secret。 

(4) 创建 ImageTarget。 
2. 导 入 视频 文件 

将 视频 文件 (本 文中 以 video.mp4 为 例 ) 放置 在 StreamingAssets 根 目录 。 
3. 视 频 AR 制作 与 运行 

将 Assets/HiAR-Unity/Prefabs 目 录 下 的 VideoPlayer 拖 至 Hierarchy 窗 口中 ， 并 将 其 设置 为 ImageTarget 的 子 项 。 


在 Hierarchy 窗 口中 选中 VideoPlayer， 在 其 对 应 的 Inspector 窗 口中 找到 Video Player Mono Behaviour。 然 后 在 Video File 选 项 中 选择 video.mp4。 
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4. 调 试 运行 
上 述 操作 完成 后 ， 需 要 在 Unity 环 境 下 运行 以 查看 效果 。 在 运行 之 前 ， 请 确保 你 的 电脑 已 安装 了 摄像 头 。 
点 击 运行 按钮 ， 摄 像 头 将 启动 并 采集 画面 ; 将 摄像 头 对 准 apple 图 片 ， 识 别 成 功 后 将 在 图 片上 去 加 视频 ， 播 放 的 内 容 为 video.mp4。 
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10.10 ”使 用 HiAR 创 建 涂 色 类 AR 应 用 


本 节 将 介绍 如 何 使 用 HiAR SDK 创 建 一 个 简单 的 涂 色 类 AR 应 用 。 


先 完成 以 下 工作 : 

(1) 新 建 Unity 工 程 并 导入 SDK。 
(2) 创建 HiARCamera。 

(3) 设置 AppKey 和 Secret。 


(4) 创建 ImageTarget。 


在 Hierarchy 窗 口中 选中 ImageTarget， 在 其 对 应 的 Inspector 窗 口中 找到 HiAR Target Mono Behaviour (Script) ， 在 Data Set 选 项 中 选择 color3D。 此 时 ， 编 辑 窗口 中 将 显示 一 张 鱼 的 图 片 ， 这 是 刚 
刚 设置 的 识别 图 片 。 (说 明 : color3D 是 SDK 中 内 置 的 本 地 识别 包 ， 供 教程 使 用 。) 


本 节 使 用 的 是 一 个 鱼 的 3D 模 型 ， 你 可 以 在 Assets/HiAR-Unity/3DModels 目 录 下 找到 名 为 fish 的 文件 。 将 fish 拖 至 Hierarchy 窗 口中 并 设置 为 ImageTarget 的 子 项 ， 适 当 调 整 位置 和 大 小 。 
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点 击 ImageTarget 下 的 fish ， 在 其 对 应 的 Inspector 窗 口中 点 击 Add Component， 依 次 选择 Scripts 一 HiAR Paint, 
4. 设 置 Shader 


在 3D 文 件 fish 的 同 级 目录 下 找到 Material 文 件 夹 并 打开 ， 找 到 对 应 的 材质 文件 fish。 点 击 fish ， 在 对 应 的 Inspector 窗 口中 找到 Shader 选 项 ， 依 次 设置 为 HiAR 一 HiARPaint。 
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25. 调试 运行 
上 述 操作 完成 后 ， 需 要 在 Unity 环 境 下 运行 以 查看 效果 。 在 运行 之 前 ， 请 确保 你 的 电脑 已 安装 了 摄像 头 。 


点 击 运行 按钮 ， 摄 像 头 将 启动 并 采集 画面 ;将 摄像 头 对 准 鱼 的 图 片 ， 识 别 成 功 后 将 在 图 片上 二 加 显示 鱼 的 模型 ， 并 且 模型 上 会 显示 对 应 涂 色 的 颜色 与 图 案 。 (说 明 : 这 里 已 经 将 图 片 打印 出 来 ， 并 且 在 
一 条 鱼 的 空 日 处 涂 上 了 颜色 。) 


10.11 多 图 识别 | 


本 节 将 介绍 如 何 使 用 HiAR SDK 的 多 图 识别 功能 来 识别 并 跟踪 多 个 目标 。 
1. 基 础 开发 及 设置 

先 完 成 以 下 工作 : 

(1) 新 建 Unity 工 程 并 导入 SDK (SDK 版 本 不 低 于 1.1.12) 。 

(2) 创建 HiARCamera。 


(3) 设置 AppKey 和 Secret。 


2. 开 局 多 图 识别 


在 HiARCamera 的 Inspector 面 板 中 找到 MultiTarget 并 勾 选 。 
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3. 设 置 ImageTarget 和 模型 


将 Assets/HiAR-Unity/Prefabs 目 录 下 的 lImageTarget 拖 至 Hierarchy 窗 口中 ， 并 将 其 设置 为 HiARCamera 的 子 项 。 同 时 添加 两 个 ImageTarget， 在 其 对 应 的 Inspector 窗 口中 找到 HiAR Target Mono 
Behaviour (Script) ， 在 Data Set 选 项 中 选择 sample， 然 后 在 ImageTarget 中 选择 识别 图 片 。 
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4. 设 置 模型 


分 别 为 两 个 ImageTarget 设 置 两 个 简单 的 模型 。 
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2. 加 载 识 别 文件 


例如 ， 可 以 通过 “点 击 事件 ”加 载 sample 中 的 apple 图 片 。 


void OnGUI () 
{ 


if (GUI.Button (new Rect (30,30,200,80),"Add Кеу")) 


{ 
AddImageTarget (System.IO.Path.Combine(Application.streamingAssets Path, "HiAR/sample"), "e589310538b636696f65caafb0ed80f0b",854,480); 
} 


3. 设 置 内 容 
当 识 别 到 动态 添加 的 key 后 ， 可 在 OnDynamicReco 中 设置 相应 展示 内 容 。 例 如 识别 后 设置 显示 一 个 cube。 


public override void OnDynamicReco (RecoResult recoResult) 


i 


GameObject gameObject - null; 
gameObject = new GameCbject(); 

if (recoResult.keyType == KeyType.IMAGE) 
{ 


gameObject . AddComponent () ; 
} 
Target target = gameObject.GetComponent (); 
target.PixelWidth = recoResult.Width * 0.01f; 
target.PixelHeight = recoResult.Height * 0.01f; 
gameObject.transform.parent = transform.parent; 
gameObject .SetActive (true); 
if (recoResult.KeyId.Equals ("e5893150385b636696f65caafb0ed80f0b") ) 
I 


GameObject cube = GameObject.CreatePrimitive (PrimitiveType.Cube); 
cube.transform.parent = gameObject.transform; 
cube.transform.localScale = new Vector3(1.0f, 1.0f, 1.0f); 
} 
bindingGameObject (gameObject, recoResult.KeyIld); 


4 .运行 以 查看 效果 
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选 则 表示 选择 了 这 个 ImageTarget 为 中 心 点 。 
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中 心 点 
在 Hierarchy 窗 口中 选择 ImageTarget， 在 其 对 应 的 Inspector 窗 口中 找到 Center Point 选 项 ， 勾 


有 些 时 候 我 们 需要 呈现 一 些 物理 碰撞 的 效果 ， 例 如 : 
但 不 设置 中 心 点 的 时 候 ， 重 力 方向 不 与 target 垂 直 (target 会 不 断 变化 ) ， 如 下 图 所 示 。 


而 设置 该 target 为 中 心 的 时 候 ， 效 果 如 下 图 所 示 。 
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11.1 基于 Wikitude SDK 开 友 AR 应 用 


Wikitude 有 限 责任 公司 是 移动 增强 现实 技术 的 先驱 ， 其 针对 智能 手机 、 平 板 电 脑 以 及 智能 眼镜 所 开发 的 AR 解 决 方案 获得 了 多 项 大 奖 。 


Wikitude 完 全 自主 研发 的 AR 技术 是 以 核心 产品 Wikitude AR SDK 以 及 一 系列 辅助 工具 的 方式 来 推 向 市 场 的 ， 帮 助 成 干 上 万 的 商标 持 有 人 、 广 告 公司 、 开 发 人 员 以 及 AR 技 术 爱 好 者 获取 理想 的 项 目 目 
标 。Wikitude 是 全 球 领先 的 AR 技 术 供应 商 ， 拥 有 数 以 万 计 的 开发 者 账户 以 及 AR 应 用 。 


1. 准 备 Wikitude 开 发 环境 
(1) 打开 Wikitude 网 站 注册 页 面 https://targetmanager-cn.wikitude.com。 


(2) 点 击 “Register now”， 如 果 已 经 注册 为 Wikitude 用 户 ， 则 输入 邮箱 和 密码 登录 Wikitude 管 理 后 台 ; 如 果 不 是 Wikitude 用 户 ， 则 点 击 注册 按钮 填写 注册 信息 。 


"е wikitude 


Please authenticate 


ا 
ASS OTO‏ 


Forgot password? 


Don't have an account yet? Register now! 


(3) 注册 完成 后 会 发 送 初始 密码 以 及 免费 Wikitude SDK 试 用 许可 证 密 钥 至 用 户 邮箱 ， 请 登录 邮箱 查看 。 
(4) 填写 注册 邮箱 和 密码 ， 登 录 Wikitude 目 标 管理 器 。 
(5) 登录 成 功 后 可 以 在 右上 角 的 设置 中 切换 语言 为 中 文 ， 这 对 于 国内 开发 者 来 说 使 用 起 来 更 为 方便 。 


(6) 下 载 Wikitude SDK for Unity。 访 问 http://www.wikitude.com/download/ 进 入 Wikitude SDK 下 载 界面 。 选 择 Wikitude SDK for Unity， 点 击 Download 默 认 下 载 最 新 版 本 的 SDK。 也 可 以 点 
击 Release Notes 查 看 历史 版 本 并 选择 合适 版 本 进行 下 载 。 本 节 使 用 最 新 的 Unity 插 件 1.2.1-1.1.0。 


ОЙ RJ 


.documentation Examples Packaqe Reference CHANGELOG.m ` Documentation. LICENSE.md 
d html 


- documentation Ж: 包含 使 用 说 明文 档 、 证 书 等 。 


Examples 目 录 : 包含 WikitudeUnityExample。 


: Package Жж: 65, 2 Wikitude.unitypackage o 
` Reference B Ж: 包含 参考 文献 。 


本 节 使 用 的 Unity 版 本 为 5.3.1f1。 


双击 Wikitude.unitypackage 文 件 ，Unity 将 加 载 并 显示 插件 内 容 ， 上 点击 Import 开 始 导 入 。 也 可 以 在 Unity 中 点 击 Assets 一 Import Package 一 Custom 
Packagehttp://www.hzcourse.com/resource/readBook?path = /openresources/teach ebook/uncompressed/15940/OEBPS/Text/... 来 导入 插件 。 
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None Cancel Import 


如 果 出 现 以 下 提示 界面 ， 选 择 “| Made a Backup.Go Ahead! ”按钮 即 可 。 


This project contains scripts and/or assemblies that use 
obsolete APIs, 


If you choose ‘Со Ahead', Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 
before proceeding. 


(You can always run the API Updater manually via the 
Assets/Run API Updater' menu command.) 


导入 完成 后 ， 可 以 在 Project 窗 口中 看 到 以 下 内 容 。 


© Unity (64bit) - Untitled - FirstWikitudeARApp - PC, Mac & Linux Standalone «2X11» lG) m: 
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至 此 ，SDK 导 入 工作 已 经 完成 ， 可 以 开始 创建 你 的 第 一 个 Wikitude 工 程 了 。 


3. 完 成 Unity 插 件 设置 
用 户 仅 需 完成 几 个 必要 的 步骤 ， 就 能 将 Wikitude Unity 插 件 添加 到 既 有 的 Unity 项 目 中 。 本 节 会 详细 解释 每 一 步 ， 它 们 是 : 
: 将 Wikitude.unitypackage 导 入 项 目 。 
: 将 WikitudeCamera 和 ClientTracker 或 CloudTracket prefab 添 加 到 Unity 场 景 层级 中 。 
. 导出 项 目 ， 修 改 Xcode Build Settings 来 完全 整合 Wikitude 原 生 SDK。 


(1) 首先 导入 Wikitude.unitypackage，Wikitude Unity 插 件 是 标准 的 .unitypackage， 可 通过 正常 Unity 包 导入 流程 进行 导入 。 在 资源 检视 面板 中 ， 右 键 点 击 并 选择 Import Package 一 Custom 
Package。 从 弹出 的 文件 浏览 窗口 中 选择 下 载 好 的 Wikitude.unitypackage 并 点 击 Open。 这 时 ， 所 有 与 Wikitude.unitypackage 相 关 的 内 容 都 会 被 导入 。 


(2) 导入 Wikitude.unitypackage 之 后 ， 其 所 有 组 件 和 脚本 都 可 用 于 定义 个 性 化 AR 体验 。 范 例 部 分 会 更 详细 地 描述 这 些 prefab 和 脚本 的 使 用 方法 。 


(3) 在 Unity 完 成 应 用 的 设置 之 后 ， 用 户 可 以 在 实体 设备 上 对 其 进行 测试 。 这 时 ， 用 户 需 要 将 其 作为 Xcode 项 目 (iOS) Android Studio 项 目 (Xem) 导出 。 
iOS 开 发 者 需要 打开 导出 的 项 目 ， 并 人 工 进行 下 列 设置 : 

- WikitudeNativeSDK ftamewotk 必 须 以 Embedded Binary 形 式 添 加 (和 欲 了 解 更 多 信息 ， 请 参考 Wikitude iOS 原 生 SDK 设 置 向 导 ) o 

- 必须 将 Build 选 项 Embedded Content Contains Swift Code 设 置 为 YES。 


不 过 很 遗憾 ， 作 为 Google Android Project 导 出 的 Unity 项 目 无 法 立即 使 用 。 用 户 需要 进行 人 工 设 定 ， 具 体 方法 如 下 。 我 们 会 给 出 两 种 不 同 的 方法 ， 用 户 选择 其 一 即 可 。 我 们 推荐 用 户 尝试 第 一 种 方 
法 ,但 对 于 某 些 用 户 ， 第 二 种 方法 也 许 更 好 。 


【方法 一 】 


1) 在 Unity 中 ， 点 击 File|Build Settingshttp://www.hzcourse.com/resource/readBook?path z /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., Google Android 
Project 并 点 击 Export。 


2) 打开 Android Studio 并 点 击 Import Project (Eclipse ADT, Gradle) 。 
3) 在 文件 选择 对 话 框 中 ， 找 到 导出 项 目的 文件 夹 ， 并 选择 以 app 命 名 的 文件 夹 〈 请 勿 选择 文件 夹 wikitude-unity-bridge) 。 
4) 在 下 一 步 中 ， 选 择 一 个 全 新 空 文件 夹 来 导入 ， 并 点 击 Next。 
5) 点 击 屏幕 上 的 Finish 完 成 导入 。 
6) 在 Android Studio 中 ， 打 开 Gradle Scripts 下 面 的 文件 settings.gradle， 并 删除 include “wikitudeunitybridge” , 
7) 打开 文件 build.gradle (Module: YOUR APP NAME) , ， 并 删除 compile project ( 'wikitudeunitybridge' ) 。 
8) 点 击 Sync Project with Gradle Files。 
9) 使 用 文件 管理 器 打开 从 Unity 导 入 Android Studio 的 那个 文件 夹 ， 并 删除 wikitude-unity-bridge 文 件 夹 。 
10) 在 当前 文件 夹 中 ， 找 到 包 和 名 /src/main/jniLibs， 并 从 每 个 子 文件 夹 中 删除 文件 libnativesdk.so。 
11) 在 Android studio 中 点 击 Filel|New|New Modulehttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...。 
12) 选择 ImportJAR/.AAR Package 并 点 击 Next。 
13) 转 到 一 开始 从 Unity 导 出 的 那个 文件 夹 ， 并 找到 以 app 命 名 的 子 文件 夹 。 
14) 在 libs 下 面 选择 文件 wikitude-unity-bridge.aar， 并 点 击 Finish。 
15) 打开 文件 build.gradle (Module: YOUR APP NAME) ， 并 在 dependencies 下 面 添加 compile project ( :wikitude-unity-bridge' ) 。 
16) 这 时 ， 项 目 就 可 以 在 Android Studio 中 运行 了 。 
【方法 二 】 


1) 在 Unity 中 ， 点 击 File|Build Settingshttp://www.hzcourse.com/resource/readBook?path z /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., Google Android 
Project 并 点 击 Export。 


2) 打开 Android Studio 并 点 击 Import Project (Eclipse ADT，Gradle) 。 

3) 在 文件 选择 对 话 框 中 ， 找 到 导出 项 目的 文件 夹 ， 并 选择 以 app 命 名 的 文件 夹 〈 请 勿 选择 文件 夹 wikitude-unity-bridge) 。 
4) 在 下 一 步 中 ， 选 择 一 个 全 新 空 文件 夹 来 导入 并 点 击 Next。 

5) 点 击 屏幕 上 的 Finish 完 成 导入 。 

6) 在 Android Studio 中， 打开 Gradle Scripts 下 面 的 文件 settings.gradle， 并 删除 include ":wikitudeunitybridge' 。 

7) 打开 文件 build.gradle (Module: YOUR APP NAME) , ， 并 删除 compile project ( 'wikitudeunitybridge' ) . 

8) 点 击 Sync Project with Gradle Files。 

9) 转 到 一 开始 从 Unity 导 出 的 那个 文件 夹 。 


10) 将 文件 [导出 文件 夹 ]/wikitude-unity-bridge/ylibs/wikitude-native-sdk.jar 和 [导出 文件 夹 ]/wikitude-unity-bridge/bin/classes.jar 导 入 到 [Android Studio 导 入 文件 夹 /YOUR-APP-NAME/libs, 
并 将 classes.jar 更 名 为 wikitude-unity-bridge.jar。 


11) 回 到 Android Studio， 打 开 build.gradle (Module: YOUR APP NAME) ， 并 在 dependencies 下 面 添 加 compile files ( ‘libs/wikitude-native-sdk.jar' ) 和 compile files ( ‘libs/wikitude- 
unity-bridge.jar ). 


12) 这 时 ， 项 目 就 可 以 在 Android studio 中 运行 了 。 


4 获取 免费 试用 版 许可 授权 


Wikitude SDK 需 要 有 效 的 授权 许可 代码 才能 正常 运行 ， 授 权 许可 的 缺失 会 屏蔽 AR 视图 ， 使 内 容 无 法 正常 显示 。 用 户 会 在 屏幕 上 看 到 印 有 License Key Missing 字 样 的 水 印 ， 所 有 的 JavaScript API 将 被 
忽略 而 不 会 执行 。 


下 载 Wikitude SDK 的 时 候 ， 用 户 会 被 带 到 授权 许可 生成 页 面 。 在 此 页 面 ， 试 用 版 授权 许可 代码 会 自动 生成 ， 用 户 也 可 登录 注册 邮箱 查找 ,注册 Wikitude 账 户 时 ， 会 给 用 户 发 送 一 封 Wikitude SDK Trial 
License 的 邮件 。 


My Licenses 


WIKITUDE SDK 
Get the free trial license key for Wikitude SDK here. Download the key file, open it and copy the key into your project. See this guide how-to enter 
your trial key for your specific platform. 


CREATED TYPE PLATFORM KEY 


2014-07-29 Trial Any Download Key 


将 授权 许可 码 复制 到 app 中 ， 这 会 解锁 Wikitude SDK 的 试用 模式 。 试 用 模式 包括 Wikitude SDK 的 所 有 功能 ， 但 会 在 屏幕 上 显示 Trial 水 印字 样 ， 每 个 试用 授权 许可 码 可 用 于 所 有 开发 平台 的 所 有 应 用 
1D， 用 户 可 在 多 个 app 中 使 用 同一 个 试用 授权 许可 码 。 


要 在 Wikitude Unity 插 件 中 使 用 授权 许可 码 ， 请 将 授权 码 粘 贴 到 WikitudeCamera prefab 的 文本 区 域内 。 


第 11 章 ”其 他 AR SDK 简 介 


11.1 基于 Wikitude SDK 开 上 友 AR 应 用 


Wikitude 有 限 责任 公司 是 移动 增强 现实 技术 的 先驱 ， 其 针对 智能 手机 、 平 板 电 脑 以 及 智能 眼镜 所 开发 的 AR 解 决 方案 获得 了 多 项 大 奖 。 


Wikitude 完 全 自主 研发 的 AR 技 术 是 以 核心 产品 Wikitude AR SDK 以 及 一 系列 辅助 工具 的 方式 来 推 向 市 场 的 ， 帮 助 成 干 上 万 的 商标 持 有 人 、 广 告 公 司 、 开 发 人 员 以 及 AR 技 术 爱 好 者 获取 理想 的 项 目 目 
标 。Wikitude 是 全 球 领先 的 AR 技术 供应 商 ， 拥 有 数 以 万 计 的 开发 者 账户 以 及 AR 应 用 。 


1. 准 备 Wikitude 开 发 环境 
(1) 打开 Wikitude 网 站 注册 页 面 https://targetmanager-cn.wikitude.com。 


(2) 点 击 “Register now”， 如 果 已 经 注册 为 Wikitude 用 户 ， 则 输入 邮箱 和 密码 登录 Wikitude 管 理 后 台 ; 如 果 不 是 Wikitude 用 户 ， 则 点 击 注册 按钮 填写 注册 信息 。 


"е wikitude 


Please authenticate 


ا 
ASS OTO‏ 


Forgot password? 


Don't have an account yet? Register now! 


(3) 注册 完成 后 会 发 送 初始 密码 以 及 免费 Wikitude SDK 试 用 许可 证 密 钥 至 用 户 邮箱 ， 请 登录 邮箱 查看 。 
(4) 填写 注册 邮箱 和 密码 ， 登 录 Wikitude 目 标 管理 器 。 
(5) 登录 成 功 后 可 以 在 右上 角 的 设置 中 切换 语言 为 中 文 ， 这 对 于 国内 开发 者 来 说 使 用 起 来 更 为 方便 。 


(6) 下 载 Wikitude SDK for Unity。 访 问 http://www.wikitude.com/download/ 进 入 Wikitude SDK 下 载 界面 。 选 择 Wikitude SDK for Unity， 点 击 Download 默 认 下 载 最 新 版 本 的 SDK。 也 可 以 点 
击 Release Notes 查 看 历史 版 本 并 选择 合适 版 本 进行 下 载 。 本 节 使 用 最 新 的 Unity 插 件 1.2.1-1.1.0。 


ОЙ RJ 


.documentation Examples Packaqe Reference CHANGELOG.m ` Documentation. LICENSE.md 
d html 


- documentation Ж: 包含 使 用 说 明文 档 、 证 书 等 。 


Examples 目 录 : 包含 WikitudeUnityExample。 


: Package Жж: 65, 2 Wikitude.unitypackage o 
` Reference B Ж: 包含 参考 文献 。 


本 节 使 用 的 Unity 版 本 为 5.3.1f1。 


双击 Wikitude.unitypackage 文 件 ，Unity 将 加 载 并 显示 插件 内 容 ， 上 点击 Import 开 始 导 入 。 也 可 以 在 Unity 中 点 击 Assets 一 Import Package 一 Custom 
Packagehttp://www.hzcourse.com/resource/readBook?path = /openresources/teach ebook/uncompressed/15940/OEBPS/Text/... 来 导入 插件 。 


Import Unity Package 


Wikitude 


v Bm Plugins 
v Bx Android 
v B ^ndroidManifest.xml 
V Bb wikitude-unity-bridge.aar 
v BIOS 
v B lbwikitude2unityBridae.a 
v ® WikitudeNativeSDK framework 
Ҹ E: Headers 
v BEBFrame.h 
У B ceometry.h 
V Matrix4.,h 
v B Pluginh 
У В RecognizedTarget.h 
V B wikitudeNativeSDK.h 
V В wrBaseTracker.h 
У B wrcaptureDeviceManaager. 


c H8 MIT... _ L=... _ 1. _ .. E 


Š 5 


1 | т | | 


None Cancel Import 


如 果 出 现 以 下 提示 界面 ， 选 择 “| Made a Backup.Go Ahead! ”按钮 即 可 。 


This project contains scripts and/or assemblies that use 
obsolete APIs, 


If you choose ‘Со Ahead', Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 
before proceeding. 


(You can always run the API Updater manually via the 
Assets/Run API Updater' menu command.) 


导入 完成 后 ， 可 以 在 Project 窗 口中 看 到 以 下 内 容 。 


© Unity (64bit) - Untitled - FirstWikitudeARApp - PC, Mac & Linux Standalone «2X11» lG) m: 


Ele Edit Assets GameObject Component Window Help 


Assets 


= 


至 此 ，SDK 导 入 工作 已 经 完成 ， 可 以 开始 创建 你 的 第 一 个 Wikitude 工 程 了 。 


3. 完 成 Unity 插 件 设置 
用 户 仅 需 完成 几 个 必要 的 步骤 ， 就 能 将 Wikitude Unity 插 件 添加 到 既 有 的 Unity 项 目 中 。 本 节 会 详细 解释 每 一 步 ， 它 们 是 : 
: 将 Wikitude.unitypackage 导 入 项 目 。 
: 将 WikitudeCamera 和 ClientTracker 或 CloudTracket prefab 添 加 到 Unity 场 景 层级 中 。 
. 导出 项 目 ， 修 改 Xcode Build Settings 来 完全 整合 Wikitude 原 生 SDK。 


(1) 首先 导入 Wikitude.unitypackage，Wikitude Unity 插 件 是 标准 的 .unitypackage， 可 通过 正常 Unity 包 导入 流程 进行 导入 。 在 资源 检视 面板 中 ， 右 键 点 击 并 选择 Import Package 一 Custom 
Package。 从 弹出 的 文件 浏览 窗口 中 选择 下 载 好 的 Wikitude.unitypackage 并 点 击 Open。 这 时 ， 所 有 与 Wikitude.unitypackage 相 关 的 内 容 都 会 被 导入 。 


(2) 导入 Wikitude.unitypackage 之 后 ， 其 所 有 组 件 和 脚本 都 可 用 于 定义 个 性 化 AR 体验 。 范 例 部 分 会 更 详细 地 描述 这 些 prefab 和 脚本 的 使 用 方法 。 


(3) 在 Unity 完 成 应 用 的 设置 之 后 ， 用 户 可 以 在 实体 设备 上 对 其 进行 测试 。 这 时 ， 用 户 需 要 将 其 作为 Xcode 项 目 (iOS) Android Studio 项 目 (Xem) 导出 。 
iOS 开 发 者 需要 打开 导出 的 项 目 ， 并 人 工 进行 下 列 设置 : 

- WikitudeNativeSDK ftamewotk 必 须 以 Embedded Binary 形 式 添 加 (和 欲 了 解 更 多 信息 ， 请 参考 Wikitude iOS 原 生 SDK 设 置 向 导 ) o 

- 必须 将 Build 选 项 Embedded Content Contains Swift Code 设 置 为 YES。 


不 过 很 遗憾 ， 作 为 Google Android Project 导 出 的 Unity 项 目 无 法 立即 使 用 。 用 户 需要 进行 人 工 设 定 ， 具 体 方法 如 下 。 我 们 会 给 出 两 种 不 同 的 方法 ， 用 户 选择 其 一 即 可 。 我 们 推荐 用 户 尝试 第 一 种 方 
法 ,但 对 于 某 些 用 户 ， 第 二 种 方法 也 许 更 好 。 


【方法 一 】 


1) 在 Unity 中 ， 点 击 File|Build Settingshttp://www.hzcourse.com/resource/readBook?path z /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., Google Android 
Project 并 点 击 Export。 


2) 打开 Android Studio 并 点 击 Import Project (Eclipse ADT, Gradle) 。 
3) 在 文件 选择 对 话 框 中 ， 找 到 导出 项 目的 文件 夹 ， 并 选择 以 app 命 名 的 文件 夹 〈 请 勿 选择 文件 夹 wikitude-unity-bridge) 。 
4) 在 下 一 步 中 ， 选 择 一 个 全 新 空 文件 夹 来 导入 ， 并 点 击 Next。 
5) 点 击 屏幕 上 的 Finish 完 成 导入 。 
6) 在 Android Studio 中 ， 打 开 Gradle Scripts 下 面 的 文件 settings.gradle， 并 删除 include “wikitudeunitybridge” , 
7) 打开 文件 build.gradle (Module: YOUR APP NAME) , ， 并 删除 compile project ( 'wikitudeunitybridge' ) 。 
8) 点 击 Sync Project with Gradle Files。 
9) 使 用 文件 管理 器 打开 从 Unity 导 入 Android Studio 的 那个 文件 夹 ， 并 删除 wikitude-unity-bridge 文 件 夹 。 
10) 在 当前 文件 夹 中 ， 找 到 包 和 名 /src/main/jniLibs， 并 从 每 个 子 文件 夹 中 删除 文件 libnativesdk.so。 
11) 在 Android studio 中 点 击 Filel|New|New Modulehttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...。 
12) 选择 ImportJAR/.AAR Package 并 点 击 Next。 
13) 转 到 一 开始 从 Unity 导 出 的 那个 文件 夹 ， 并 找到 以 app 命 名 的 子 文件 夹 。 
14) 在 libs 下 面 选择 文件 wikitude-unity-bridge.aar， 并 点 击 Finish。 
15) 打开 文件 build.gradle (Module: YOUR APP NAME) ， 并 在 dependencies 下 面 添加 compile project ( :wikitude-unity-bridge' ) 。 
16) 这 时 ， 项 目 就 可 以 在 Android Studio 中 运行 了 。 
【方法 二 】 


1) 在 Unity 中 ， 点 击 File|Build Settingshttp://www.hzcourse.com/resource/readBook?path z /openresources/teach ebook/uncompressed/15940/OEBPS/Text/..., Google Android 
Project 并 点 击 Export。 


2) 打开 Android Studio 并 点 击 Import Project (Eclipse ADT，Gradle) 。 

3) 在 文件 选择 对 话 框 中 ， 找 到 导出 项 目的 文件 夹 ， 并 选择 以 app 命 名 的 文件 夹 〈 请 勿 选择 文件 夹 wikitude-unity-bridge) 。 
4) 在 下 一 步 中 ， 选 择 一 个 全 新 空 文件 夹 来 导入 并 点 击 Next。 

5) 点 击 屏幕 上 的 Finish 完 成 导入 。 

6) 在 Android Studio 中， 打开 Gradle Scripts 下 面 的 文件 settings.gradle， 并 删除 include ":wikitudeunitybridge' 。 

7) 打开 文件 build.gradle (Module: YOUR APP NAME) , ， 并 删除 compile project ( 'wikitudeunitybridge' ) . 

8) 点 击 Sync Project with Gradle Files。 

9) 转 到 一 开始 从 Unity 导 出 的 那个 文件 夹 。 


10) 将 文件 [导出 文件 夹 ]/wikitude-unity-bridge/ylibs/wikitude-native-sdk.jar 和 [导出 文件 夹 ]/wikitude-unity-bridge/bin/classes.jar 导 入 到 [Android Studio 导 入 文件 夹 /YOUR-APP-NAME/libs, 
并 将 classes.jar 更 名 为 wikitude-unity-bridge.jar。 


11) 回 到 Android Studio， 打 开 build.gradle (Module: YOUR APP NAME) ， 并 在 dependencies 下 面 添 加 compile files ( ‘libs/wikitude-native-sdk.jar' ) 和 compile files ( ‘libs/wikitude- 
unity-bridge.jar ). 


12) 这 时 ， 项 目 就 可 以 在 Android studio 中 运行 了 。 


4 获取 免费 试用 版 许可 授权 


Wikitude SDK 需 要 有 效 的 授权 许可 代码 才能 正常 运行 ， 授 权 许可 的 缺失 会 屏蔽 AR 视图 ， 使 内 容 无 法 正常 显示 。 用 户 会 在 屏幕 上 看 到 印 有 License Key Missing 字 样 的 水 印 ， 所 有 的 JavaScript API 将 被 
忽略 而 不 会 执行 。 


下 载 Wikitude SDK 的 时 候 ， 用 户 会 被 带 到 授权 许可 生成 页 面 。 在 此 页 面 ， 试 用 版 授权 许可 代码 会 自动 生成 ， 用 户 也 可 登录 注册 邮箱 查找 ,注册 Wikitude 账 户 时 ， 会 给 用 户 发 送 一 封 Wikitude SDK Trial 
License 的 邮件 。 


My Licenses 


Get the free trial license key for Wikitude SDK here. Download the key file, open it and copy the key into your project. See this guide how-to enter 


WIKITUDE SDK 


vour trial kev for your specific platform. 


CREATED TYPE 
Trial Any 


PLATFORM KEY 
Download Key 


2014-07-29 
将 授权 许可 码 复 制 到 app 中 ， 这 会 解锁 Wikitude SDK 的 试用 模式 。 试 用 模式 包括 Wikitude SDK 的 所 有 功能 ， 但 会 在 屏幕 上 显示 Trial 水 印字 样 ， 每 个 试用 授权 许可 码 可 用 于 所 有 开发 平台 的 所 有 应 用 


ID， 用 户 可 在 多 个 app 中 使 用 同一 个 试用 授权 许可 码 。 
要 在 Wikitude Unity 揪 件 中 使 用 授权 许可 码 ， 请 将 授权 码 粘 贴 到 WikitudeCamera prefab 的 文本 区 域内 。 


11.2 基于 VoidAR SDK 开 改 AR 应 用 
太 虚 AR SDK (VoidAR) 是 国内 团队 自主 研发 的 增强 现实 引擎 。 该 引擎 在 2015 年 9 月 30 日 发 布 了 alpha 0.02 版 本 ， 具 有 “手绘 识别 、 模 糊 识别 、 强 稳定 性 、 空 间 构 建 ”的 功能 特点 ， 并 且 免 费 开放 使 


FB. 


1. 注 册 成 为 VoidAR 用 户 
(1) 在 浏览 器 中 打开 链接 http://cloudar.ionhammer.cn:8080/develop/html/register.jsp， 填 写 邮箱 信息 进行 注册 ， 注 册 完 成 后 会 跳 转 到 登录 页 面 ， 使 用 注册 时 的 邮箱 账号 和 密码 即 可 登录 ，。 


(2) 若 已 有 太 虚 账号 可 在 浏览 器 中 打开 http://cloudar.ionhammer.cn:8080/developyhtmlylogin.jsp， 即 可 登录 到 太 虚 引擎 的 云 数 据 库 。 


2. 下 载 VoidAR SDK for Unity 
在 百度 云 盘 下 载 界 面 选 择 所 需 版 本 并 下 载 VoiAR SDK for Unity， 本 节 下 载 版 本 为 v0.09。 下 载 完成 后 可 以 获得 一 个 名 为 v0.09 的 文件 夹 ， 打 开 可 以 看 到 如 下 文件 。 


HE pE 
п m" m" pm," 4) X EN | \ 


VoidAR-v0.0.9(6 — WebAPIDemo.zi TEETER 
БҮТ nitypacka ge imBB.doc 


VoidAR-v0.0.9(3 
P 


2).unitypackage 


VoidAR 0.09 = VoidAR 0.09 45 VoidAR 0.09 = 
ChangeLog.d oc PEETS. HME. doc ARATE doc 
doc 


VoidAR 0.09 


可 使 用 Unity 3D 的 32 位 或 者 64 位 5.x (建议 使 用 5.2.0) . 


3. 新 建 Unity 工 程 
骤 新 建 一 个 Unity 工 程 。 当 然 ， 也 可 以 直接 打开 已 存在 的 工程 来 进行 导入 工作 。 


运行 Unity 程 序 ， 并 按照 步 


Projects Getting started 


Project пагте“ 


FirstVoidARAppl 


Locatror* 


FnityProject "e" 


3 D 2D =i Create project 


= 


4. 导 入 VoidAR SDK for Unity 插 件 


打开 Unity 3D 之 前 建立 的 工程 ， 右 键 点 击 Assets， 选 择 Import Package， 继 续 选择 Custom Package， 选 择 VoidAR-v0.0.9 (32) .unitypackage (对 应 32 位 的 Unity) 或 者 VoidAR- 
v0.09 (64) .unitypackgae (对 应 64 位 的 Unity) 。 


存放 unitypackage 的 路 径 中 不 要 有 中 文 ， 否 则 会 导入 不 成 功 。 


g Unity (64bit) - Urratled - Test1 - PC, Мас & Linu« Standalone «DX11» 
File Edit Assets GameObject Component Window Help 


D Assets 


P * 


Import Unity Package — 


|| VoidAR-v0.0.9(64) 


artoon Character 
7 == CODI 
v 55 cC001.fb» 
v Bi coo fb» 
V бш Materials 
V @соо1 cloth.mat 
v Bicoo c Ло, PNG 
¥ @соо1 faceoo. 
v соо xu ceDD. i NG 
Ў Ф с001 Char.prefab 
v 28 Desk 
V Bi desk .FB> 
v Bm Materials 


V 8 standard 


c ЖЕ —M v NEN 


. amat 


^ [| Mone Cancel 


如 果 出 现 以 下 提示 界面 ， 点 击 “| Made a Backup.Go Ahead! ”按钮 即 可 。 


Import 


This project contains scripts and/or assemblies that use 
obsolete APIs. 


If you choose Go Ahead , Unity will automatically 
upgrade any scripts/assemblies in the Assets folder 
found using the old APIs. You should make a backup 


before proceeding. 


(You can always run the API Updater manually via the 
Assets/Run АРІ Updater menu command.) 


I Made a Backup. Go Ahead! I 


导入 完成 后 ， 可 以 在 Project 窗 口中 看 到 以 下 内 容 。 


€ Unity (64bit) - Untitled - Тез - PC, Mac & Linu« Standalone <DX11> ا‎ X 
File Edit Assets GasmeObject Component Custom Editor Window Hap 


至 此 ，SDK 导 入 工作 已 经 完成 。 


E eet 


5. 完 成 第 一 个 VoidAR 场 景 的 搭建 
(1) 打开 之 前 创建 的 FirstVoidARApp 工 程 。 


(2) 选中 Assets/VoidAr/Scene， 文 件 里 存放 了 0.09 版 本 的 所 有 demo、CloudDemo、DynamicLoadDemo、lmageDemo、ShapeDemo 和 VideoDemo。 


Create 

Yr Favorites 
(Д All Materials 
Q All Models 
Q All Pretabs 
Q All Scripts 


= Assets 
Bs Myassets 
in Cart 


toon C haractel 


Es Marine 


Bm Android 
L 105 


- сус, 


= StreamingAssets 


AllDemo CloudDemo DynamicLoadDe.. ImageDemo ShapeDemo VideoDemo 


(4) 点 击 开始 按钮 即 可 运行 DEMO 程序 ， 效 果 如 下 。 


ml/register.jsp 进 行 注册 。 


Dr LLIS INS 


AS A BE Ct erm | FER E халиа 


VoldAR 


(2) 登录 。 在 浏览 器 打开 http://cloudarionhammer.cl elop/html/login.jsp 进 行 登录 。 


"xw 


4 F amc Aa “eruh 1 т 
EKO > eez "RIT Las *c<¿; LIT 


"REM жо "TA Ur ki. 


ELS UAE KEDE жим C DOSE 


Tut AC 


创建 成 功 后， 可 以 得 到 accessKey 和 secretKey 信 息 ， 用 于 客户 端 访问 。 


s. ето CASE FELE WENE BE 


wes nmt h ry 


ль: hEllaliT аала Y 


perik © жаз з SW 4 TM S11 F FE 


NERO tr 


орум € Xt оњ И W d KPC 


- R nb amma гт 


SENS O жек 


E nal 


Cope e mtn rM L.I F. Pa 


填写 相关 图 片 信息 并 选择 要 上 传 的 识别 图 片 (assetbundle 相 关 项 可 不 填写 ) ， 点 击 右 下 角 的 “保存 ”按钮 进行 上 传 。 


ET d GK irm NO +т= PR 


МАЙ аньана үл 


Ln Ца не 


(5) 管理 assetbundle。 点 击 右边 的 “修改 ”按钮 。 


E an т ы. ۴ 


я) "S 45 VARRE кет тт .таљттан 


填写 assetbundle 相 关 数据 (必须 选择 平台 和 上 传 文件 ) ,点 击 右 下 角 的 “保存 ”按钮 进行 上 传 。 


«л ыт ea P 


SETS 45 Омак "REM тү er AT RH, 


Affari ТЕ гї їл 


Af... t... 


89. Pe 


删除 各 平台 的 assetbundle (必须 选择 平台 并 选中 删除 选项 ) ， 点 击 右 下 角 的 “保存 ”按钮 进行 上 传 。 


assetbundle 平 台 相 关 信 息 : 已 上 传 了 assetbundle 的 平台 显示 为 绿色 ， 没 有 则 为 灰色 。 


(1) 首先 安装 Unity 3D， 目 前 支持 的 Unity 3D 版 本 为 5.x 版 。 


(2) 打开 Unity 3D， 新 建 一 个 工程 ， 右 击 Assets， 选 择 Import Package， 继 续 选 择 Custom Package， 随 后 选择 VoidAR-v0.0.8 (32) .unitypackage (32 位 Unity) 或 者 VoidAR- 
v0.0.8 (64) .unitypackage (64 位 Unity) 。 


~ ЖАБА ль? ге 


IED A aK FELS wv De 


4% & 
AQAR 
GN Garant кё {О + 


W Af. ta. 


(3) 在 Unity 3D 中 点 击 File 按 钮 选择 New Scene 创建 一 个 新 的 场景 ， 新 场景 自 带 了 一 个 Main Camera, 


Hierarchy 
LL: + 


(4) 删除 新 场景 中 自 带 的 Main Camera, 


(5) 在 Assets 文 件 夹 下 找到 VoidAR 文 件 夹 ， 将 其 中 Prefab 文 件 夹 下 的 “ALL” 预 制 件 拖 到 场景 中 。 


Project "E = Hierarchy 


Create - т Create = 


Wr Favorites ssets = VoildAR » Prefab 
Q All Materials 
Q All Models 
Q All Prefabs 
а All Scripts 


= Assets 
Bs Myassets » 
Ë= Editor XI | ARCamera 
— Plugins 
Bs StreamingAssets 
Bs VoidAR 
— Models 
E Prefab 
Es Scene 
"ш Script BGImage ImageTarget 


在 “All” 预 制 件 中 的 MainCamera 上 ，Marker Type 的 选项 Image 表 示 图 片 识别 ，Shape 表 示 手 绘 识别 ， 目 前 暂 不 支持 Shape 和 Image 混 用 。 


= Hierarchy 
Create = 
AI 
ARC amera 
* MainCamera 
B.G Il lace 
Directional lignt 
*Tank Market 
LIT 
ImageTarget 


将 Prefab 文 件 下 的 “ImageTarget” 预制 件 拖 到 场景 中 。 


显示 的 模型 拖 动 到 场景 中 的 ImageTarget 里 面 。 


c [Account =! 


-= Inspector 
V MainCamera 


Tag МаітСатеѓа 


Prefab | Select 


J Transform 
Position XD 
x 90 
Scale X 1 


Rotation 


ê: V Camera 
Clear Flags 
Background 
Culling Mask 


Projection 
Size 


Clipping Planes 


Viewport Rect 

> 0 

W 1 
Depth 
Rendering Path 
Target Texture 
Occlusion Culling 
HDR 
g ¥ GUI Layer 
m" Flare Layer 


(® V Audio Listener 
8 V Main (Script) 


Script 

AR Camera 
Target Frame Rate 
Marker Type 


Layers 


+ Layer 


Revert 


Y 100 
Y Ü 
Y d 


Skybox t 


Mixed. — 


Orthe graphic 
5 

Mear 0,3 
Far 1000 


Use Player Settings + 
None (Render Textu © 
v 

m ©, 
g +, 
w ©, 
"o, 
В Main o 
e ARCamera (Came © 
لاك‎ 


将 刚才 拖 入 ImageTarget 里 面 的 模型 拖 动 到 Marker 的 model 里 面 。 


在 Image File Path 里 面 填写 图 片 的 名 字 ， 例 如 10jpg (此 版 本 暂时 需要 手动 填写 ) ， 目 前 版 本 图 片 必须 放 人 在 streamingAssets 文 件 夹 下 。 


i = Hierarchy -= Ө Inspector 
& ' Create = All vV ImageTarget 
Assets » StreamingAssets Aj Tag (Untagged P Layer (DH 


Prefab | Select | Revert Apply ` 


P. Transform 
Position 


Bolmage 
Directional light 
UI Rotation 
* ImageTarget Scale 
MarineTarget В 7 Marker (Script) 
Script B Marker 
Model Ф MarineTarget 
Image File Path 
1 Оуцап ba. 


(6) 将 Prefab 文 件 下 的 “UI” 拖 动 到 场景 中 ， 这 里 的 UI| 主 要 是 两 个 按钮 ， 一 个 按钮 的 作用 是 添加 目标 ， 另 一 个 按钮 的 作用 是 清空 添加 的 所 有 目标 。 用 户 也 可 自 定义 UI 自己 调用 
addCurrentShapelmageTarget()、reset() 等 接口 ， 无 需 拖 动 Ul。 


Project = “= Hierarchy 


Create = Create + 


Yr Favorites Ass > VoidAR > Prefab A || 
Q All Materials ImageTarget 
Q AI Models "| 
Q) All Prefabs 


Q All Scripts 


L Assets 

Bm Myassets 
Ex Marine 
Es Prefab 
Bm Tani. 
Bs Textures 

L Editor 

== Plugins 

Em StreamingAssets 

Ss VoidAPR 
— Models 
= Prefab 
Bs Script 


АКС атага 


BGImage 


Main. агага 


Webcam 


(7) 点 击 运 行 就 可 测试 。 


在 点 击 “ 添 加 目标 ”时 ， 必 须 垂直 正 对 目标 ， 这 样 效果 最 好 ! 
8. 云 识别 的 使 用 
文档 说 明 : 使 用 接口 前 需要 先 到 开发 者 平台 进行 如 下 操作 。 
: 注册 (http://cloudar.ionhammer.cn:8080/develop/html/register.jsp) o 
. 登录 (http://cloudar.ionhammer.cn:8080/develop/html/login.jsp) o 
° 新 建 云 数据 库 ， 取 得 该 数据 库 的 accessKey 和 和 secretKey。 


接口 说 明 : 接口 均 使 用 http post 方 式 访问 ， 请 求 参数 和 返回 结果 均 为 json 格 式 ， 并 且 需 要 在 http header 中 增加 “Authorizationg” 项 进行 访问 权限 设置 ， 格 式 为 “accessKey: secretKey”， 具 体 使 
用 可 参考 接口 演示 程序 。 


(1) 上 传 图 片 
接口 说 明 : 上 传单 张 图 片 到 指定 的 云 数据 库 。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/uploadTarget.do, 


名 称 备注 
name KRZR, DENS, AKIE 50 字符 
matadata 日 定义 数据 ， 可 以 为 空 ， 最 大 长 度 200 字符 
imagedata 图 上 请 数据， 不 能 为 室 ， 需 要 进行 base64 编码 ， 大 小 最 大 为 2M 


Json 数 据 : 


("name" :"10.5pg", "metadata" : "dGVzdA" , " imagedata" : " "AAQSkZJRgAhttp: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...") 


"coge" : "TON. / / 3 EX #0, 0 表示 成 功 
"msg":" 上 传 成 功 ",// 返 回信 息 
"image":{// 图 片 详细 信息 
"wigd":3521,// 图 片 ID 
"name" : "10 - jpg", / /和 名称 

"metadata": "test", // 自 定义 数据 

"zating" :5 // 识 别 度 评 分 (1-ž, 2- LE, 32-3, 4-44, 5-4) 
"bundle":"0,0,0,0",//Æ FRÆ У assetbundle (ios, android, windows, mac) 
// 等 于 0 表示 没有 绑 定 ， 大 于 0 表示 已 绑 定 

"CreateTime":"2016-03-30 14:11:19"// 上传 时 间 

) 

) 


失败 : 


{ 

"code" : niu // 返 回 代 码 ， 1 表示 失败 
"msg": "图片 上传 失败 "// 失 败 描 述 

} 


演示 程序 : AddTarget.java。 
(2) 取得 图 片 列表 
接口 说 明 : 从 云 数 据 库 取得 指定 数量 的 图 片 信 息 。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/targetList.do, 


请 求 参 数 

名 称 类 型 &i 

start 记录 开始 位 轩 

num 记录 数量 ， 最 大 值 为 20 
Json 数 据 : 


{"start” :0,” num :10} 


{ 
"code"m:"0")// 返 回 代码 ， 0 表示 成 功 
"msg" :"", / /返回 信息 


"total":1,//EH A š AK 
"data": [{// 图 片 详细 信息 
"id":3521,//ÉE] K ID 
"name" : "10 . jpg", ГАЖ 

"metadata":"test",// 自 定义 数据 

"rating":5,// 识 别 度 评分 (1- 差 ,2- 较 差 , 3- 中 ,4- 较 好 , 5- 好 ) 
"bundle":"0,0,0,0",// 是 否 绑 定 了 assetbundle (ios,android,windows,mac) 
// 等 于 0 表示 没有 绑 定 ， 大 于 0 表示 已 绑 定 

"CreateTime":"2016-03-30 14:11:19"// 上 传 时 间 

}] 

} 


{ 

"code" : "num // 返 回 代 码 ， 1 表示 失败 
"msg" :" 请 求 数据 传输 错误 "// 失 败 描述 
} 


演示 程序 : TargetList.java, 
(3) 上 传 assetbundle 
接口 说 明 : 上 传 Unity 打 包 的 assetbundle 文 件 到 云 数 据 库 ， 并 与 指定 图 片 绑 定 。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/uploadBundle.do, 


名 称 类 型 备注 
T IDE 
platform Wf, l-ios, 2-android, 3-windows, 4-mac 
bundle assetbundle 数据 ， 不 能 为 空 ， 需 要 进行 base64 2810, fg X A 2M 


Json 数 据 : 


{"id” :3521," platform :1," bundle" :" Wi5pdHlXZhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15940/OEBPS/Text/..." ] 


{ 

"code" : "on. // 返 回 代 码 ， 0 表示 成 功 
"msg":"assetbundle 上 传 成 功 "// 返 回信 息 
} 


失败 : 


{ 

"code":"1",// KARA, 1Жж FIK 
"msg":" 请 求 数据 传输 错误 "// 失 败 描 述 
} 


演示 程序 : UploadBundle.java, 
(4) 取得 图 片 详细 信息 
接口 说 明 : 从 云 数 据 库 取得 指定 图 片 的 信息 。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/targetDetail.do, 


请 求 参 数 : 
名 称 备注 
id 图 片 ID 
Json 数 据 : 
{"їа” 73521} 
返回 结果 
成 功 : 


{ 

"code" :"0",//i& 9/42, OR IR LJ 
"msg" : " ur // 返 回信 息 
"image":{// 图 片 详细 信息 
"14":3521,//8 A ID 
"name" : "10 - jpg", // 名 称 

"metadata":"test",// 自 定义 数据 

"rating":5,// 识 别 度 评分 (1- 差 ,2- 较 差 , 3- 中 ,4- 较 好 , 5- 好) 
"bundle":"2,0,0,0",//zX FRZ f assetbundle (ios,android,windows,mac) 
// 等 于 0 表示 没有 绑 定 ， 大 于 0 表示 已 绑 定 

"CreateTime":"2016-03-30 14:11:19"// 上 传 时 间 

} 

} 


失败 : 


{ 

"Code" :"1",//ik MAJA, 14 AM 
"msg":" 请 求 数据 传输 dX" / /失败 描 述 
} 


演示 程序 : TargetDetail.java, 
(5) 删除 图 片 
接口 说 明 : 从 云 数据 库 删 除 指定 图 片 。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/deleteTarget.do, 


请 求 参 数 
名 称 备注 
id AD 
Json 数 据 : 
("id" :3521) 
返回 结果 
成 功 : 


{ 

"code" : "ow. // 返 回 代 码 ， 0 表示 成 功 
"msg" : "删除 成 功 "// 返 回信 息 

} 


失败 : 


{ 

"сойе": "1", // 返 回 代 码 ，1 表 示 失 败 
"msg": "请 求 数据 传输 错误 "// 失 败 描述 
} 


演示 程序 : DelTarget.java, 
(6) 删除 assetbundle 
接口 说 明 : 删除 指定 图 片 绑 定 的 assetbundle。 


接口 地 址 : http://cloudar.ionhammer.cn:8080/develop/ws/deleteBundle.do, 


请 求 参数 : 
аю xm 
platform — [+ 

Json 数 据 : 


[К H ID 


平台 


3 


l-ios, 


备注 


2-android, 3-windows, 


4-mac 


а” :3521," platform :1} 


"code" :"0",//i& EMX ES, OX RA 
"msg" : "Ji F 除 assetbundle 成 功 "// 返 回信 息 1А 
} 


失败 : 


{ 

"code":"1",//i& EN ES, 14 AC 
"msg": "请 求 数据 传输 错误 "// 失 败 描述 
} 


演示 程序 : DelBundle.java, 


(7) code 说 明 


ma | — r [wd T 


0 成 功 401 权限 销 误 ，accessKey secretKey 销 误 
r | SEEN NN | 系统 错误 


演示 程序 使 用 说 明 : 安装 JDK1.7 和 Eclipse， 然 后 将 演示 工程 导入 Eclipse (File—Importhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15940/OEBPS/Text/...—General—Existing Projects into Workspace 一 Next) 即 可 运行 。 
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121 什么 是 找 趣 


找 趣 是 由 Realmax 打 造 的 一 款 面 向 用 户 的 增强 现实 制作 平台 与 操作 系统 ， 致 力 于 为 使 用 者 提供 高 效 简便 的 AR 制作 环境 和 统一 的 AR 操作 系统 入 口 。 


找 趣 旨 在 提供 简单 易 用 、 功 能 完善 的 AR 创作 服务 ， 包 括 AR 制作 管理 后 台 、3D 图 形 化 编辑 器 、AR 浏 览 器 和 AR 创意 商城 ; 同时 ， 找 趣 开放 了 众多 企业 通用 的 项 目 模板 以 及 定制 化 的 AR 解决 方案 。 
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找 趣 是 由 Realmax 打 造 的 一 款 面 向 用 户 的 增强 现实 制作 平台 与 操作 系统 ， 致 力 于 为 使 用 者 提供 高 效 简便 的 AR 制作 环境 和 统一 的 AR 操作 系统 入 口 。 


找 趣 旨 在 提供 简单 易 用 、 功 能 完善 的 AR 创作 服务 ， 包 括 AR 制 作 管理 后 台 、3D 图 形 化 编辑 器 、AR 浏 览 器 和 AR 创意 商城 ; 同时 ， 找 趣 开放 了 众多 企业 通用 的 项 目 模板 以 及 定制 化 的 AR 解决 方案 。 


12.2 REE 


找 趣 后 台 是 找 趣 云 平台 的 重要 组 成 部 分 ， 承 载 了 找 趣 的 大 部 分 功能 ， 旨 在 建立 一 个 一 站 式 的 管理 和 服务 中 心 。 


1. 注 册 / 登 录 / 注 销 


在 登录 页 面 内 ， 输 入 正确 的 邮箱 /手机 号 、 密 码 和 随机 验证 码 ， 上 点击“ 登录 ”按钮 。 


登录 页 面 内 ， 选 择 QQ/ 新 浪 微 博 / 微 信 的 方式 ， 在 打开 的 页 面 中 输入 账号 、 密 码 ， 进 行 快速 登录 。 
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登录 成 功 后 ， 系 统 将 自动 跳 转 到 后 台 首 页 。 


2. 重 置 密 码 


如 果 无 法 访问 账户 ， 可 以 重新 设置 密码 。 在 登录 页 面 下 方 ， 点 击 “ 忘 记 密码 ? ”并 前 往 重 置 页 面 。 
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输入 电子 邮箱 或 者 手机 号 码 ， 点 击 “ 获 取 验 证 码 ”按钮 。 


系统 会 向 你 的 邮箱 /手机 号 中 发 送 一 封包 含 验证 码 的 邮件 /短信 。 


找 趣 平台 验证 码 r 


发 件 人 : RAFA <email@realcast.realmax.com> [E] 
时 间 : 2016 年 3 月 8 日 (星期 一 ) 下 午 3:22 
HEA : WS o 、 


找 趣 用 户 ， 你 好 ! 


你 的 当前 验证 但 为 : 
989936 


此 验证 码 30 分 钟 内 有 效 ， 如 验证 码 失 效 请 返回 原 页 面 重新 操作 ! 
找 趣 团队 


返回 登录 页 面 ， 将 得 到 的 验证 码 填 入 验证 码 框 ， 并 输入 新 密码 ， 点 击 “ 确 认 ” 按 钮 即 可 重 置 密 码 ， 重 置 成 功 后 系统 会 自动 跳 转 回 登 录 页 面 。 
3. 修 改 密码 


登录 找 趣 后 台 ， 点 击 界面 右上 角 的 账户 名 ， 在 弹出 的 菜单 中 选择 “我 的 账户 ”以 进入 账户 信息 界面 。 


Q BAAS SIER 素材 内 容 x” stam 反 馆 建议 帮助 文档 NEw о aus 


我 的 场景 + тае 


在 登录 密码 右 侧 点 击 “ 修 改 ”。 


Q BAAS 。 ”我 的 项 目 SHAR- єп кагы 帮助 文档 ew e. 


我 的 账户 


在 弹出 的 页 面 中 输入 正确 的 旧 密码 以 及 两 次 新 密码 ， 保 存 后 完成 密码 修改 。 


点 击 界 面 右 上 角 的 账户 名 ， 在 弹出 的 菜单 中 选择 “我 的 账户 ”以 进入 账户 信息 界面 。 在 账户 信息 页 面 中 可 以 看 到 当前 账户 的 一 些 基 本 信息 。 


登录 找 趣 后 台 ， 


: deeerr 修改 


用 户 名 
ERR ° ia D 


: 2016-07-15 16:41:19 


= : 正常 


点 击 左 上 和 角 的 图 片 可 上 传 一 张 头像 ， 点 击 邮箱 右边 的 “修改 ”可 更 换 登 录 邮箱 ; 绑 定 手机 号 、QQ、 微 博 账 户 ， 以 便 下 次 直接 使 用 三 方 登录 。 


创建 场景 需要 从 创建 项 目 开 始 。 首 次 登录 后 ， 系 统 会 新 增 一 个 默认 项 目 ， 用 户 可 以 在 默认 项 目 中 添加 场景 ， 也 可 以 选择 新 建 一 个 自 定义 项 目 。 


在 我 的 项 目 页 面 选择 “新 建 项 目 ”， 将 会 出 现 以 下 界面 。 
(1) 基本 信息 : 输入 项 目 名 (*) 、 项 目 封面 图 (*) 、 标 签 和 项 目 描述 


(2) 设置 。 


SA Im Hb3f0 
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AF: 公开 的 项 目 将 会 出 现在 找 趣 App 页 面 内 ， 其 他 用 户 可 以 搜索 到 该 项 目 并 进入 查看 。 
` 云 识别 : 打开 后 ， 项 目下 可 容纳 千 万 张 识别 图 ， 可 以 快速 打开 项 目 ; 关闭 后 为 离线 识别 ， 项 目 内 最 多 容纳 100 张 识别 图 ， 且 识别 图 越 多 ， 打 开 项 目 越 慢 。 
: 局 用 后 ， 可 以 使 用 找 趣 App 的 云端 扫描 识别 封面 图 、 进 入 项 目 〈 效 果 等 同 于 频道 二 维 码 ) ， 此 功能 须 经 管理 员 审 核 。 


保存 后 ， 系 统 自 动 跳 转 至 “我 的 项 目 ”页 面 。 此 时 ， 可 前 往 “ 我 的 场景 ”页 面 开 始 创建 场景 。 


124 制作 场景 


1. 准 备 


一 个 完整 的 场景 需要 包含 下 面 两 部 分 素材 : 


识别 图 : AR 对 象 的 载体 ， 基 于 二 维 图 片 的 识别 要 求 上 传 一 张 符合 规范 的 图 片 ， 格 式 为 .jpg。 


. AR 内 容 : 将 要 呈现 出 来 的 AR 对 象 ， 类 型 为 模型 和 图 片 ， 需 要 将 AR 对 象 转换 成 找 趣 要 求 的 格式 。 
2. 制 作 


登录 找 趣 云 平台 ， 在 我 的 场景 页 面 下 内 选择 “模板 新 建 ”或 者 “编辑 器 新 建 ”， 进 入 制作 界面 。 


我 的 项 目 


编辑 项 新 过 


3. 模 板 新 建 


在 提供 的 列表 里 点 击 一 个 合适 的 模板 。 


Q 


新 建 场景 


M 


按照 顺序 输入 场景 信息 (所 属 项 目 、 名 称 和 描述 ) 。 


Q 我 的 场景 我 的 项 目 。 ”素材 内 容 ” ння 


上 传 识别 图 和 和 AR 对象 (资源 ) 。 修 改 场景 设置 ， 如 不 需要 调整 ， 则 空置 。 


上 传 识 别 图 * 


可 、 上 前 识 刘 图 只 支持 pg 格式 ， 昌 最 大 为 7M 本 、 旺 前 图 片 支持 jpg\png 格 式 ， 夭 大 为 7N 
*2. RIEMERS ЕЕ, ЖҮЗ A TERES ER 


*3、 识 别 图 攻 宽 比例 在 32 ( 2:3 ) 或 和 3 ( 34) 


场景 设置 * 


提交 后 即 可 生成 场景 ， 页 面 上 会 显示 查看 场景 的 方法 。 
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SAS Lf 


HE HE , F3KOGaRAPP Tim mg , AIRE 扫 摘 识别 图 ， 查 埋 AR 效果 


点 击 AR 编 辑 器 后 进入 场景 信息 页 面 ， 填 写 场景 的 属性 和 识别 图 。 


请 对 此 场景 进行 “个 简单 的 岳 述 


(1) 基本 信息 : 所 属 项 目 、 场 景 名 称 和 场景 描述 。 
(2) 识别 图 : 选择 一 张 jpg 格 式 的 图 片 作为 AR 识 别 图 。“ 分 享 到 云端 扫描 ”决定 了 是 否 能 够 通过 找 趣 App 的 云端 识别 界面 直接 扫描 图 片 、 查 看 该 AR 对 象 。 


保存 后 进入 编辑 器 页 面 。 左 上 和 角 可 选择 更 换 识别 图 /增加 模型 /图 片 ， 等 候 加 载 成 功 。 在 编辑 框 内 可 调整 AR 对 象 与 识别 图 的 相对 位 置 。 


жже 


EENS 


EHE RSS IBI 


循环 播放 


右边 属性 列表 内 有 三 个 切换 选项 ， 分 别 为 : 


8 (允许 修改 是 否 分 享 到 云端 ) ; 同 项 目下 不 同 场景 的 结构 图 ， 允 许 直 接点 击 场景 进行 切换 编辑 (切换 前 请 确定 已 保存 对 当前 场景 的 修改 ) 。 


修改 AR 内 容 的 属性 设 定 ， 包 括 名 称 、 是 否 可 见 、 状 态 参数 、 加 载 类 型 、 状 态 和 手势 。 


对 象 设置 : 修改 AR 对 象 的 属性 设 定 ， 包 括 名 称 、 替 换 当 前 对 象 、 相 对 位 置 、 动 态 加 载 、 是 否 可 见 、 是 否 启 用 、 黑 认 手 势 以 及 对 象 相关 的 快速 设置 。 


` 功能 设置 : 设置 与 当前 AR 对 象 相 关 的 事件 交互 ， 查 看 已 添加 的 功能 列表 (事件 交互 的 具体 功能 定义 在 后 面 章节 有 详 


素材 上 传 完成 后 ， 开 始 给 AR 对 象 设置 事件 交互 。 选 中 某 一 对 象 ， 右 侧 属 性 列表 切换 至 功能 设置 ， 选 择 一 个 功能 。 


: MERE | 


已 添加 功能 列表 


在 弹出 的 窗口 中 输入 功能 相关 的 设置 。 选 择 触 发 时 机 ， 若 希望 扫描 到 时 就 发 生 ， 则 直接 选择 “扫描 到 ” “扫描 丢失 ”事件 。 某 一 特定 AR 对 象 的 特定 事件 则 可 在 时 机 列表 中 拉 选 。 


HESE | == ` 


按照 需求 依次 编辑 完成 后 ， 点 击 “ 保 存 ” 按 钮 ， 制 作 过 程 结束 。 


12.5 ”如 何 使 用 找 趣 

找 趣 浏览 器 提供 了 大 量 的 展示 项 目 ， 可 以 让 AR 新 手 快 速 了 解 AR、 喜 欢 AR。 对 找 趣 用 户 而 言 ， 它 还 是 一 个 超级 管家 ， 你 的 每 一 次 灵光 闪现 都 将 被 记录 下 来 ， 如 果 你 愿意 ， 还 可 以 将 它 展现 给 所 有 找 趣 用 
户 ， 轻 松 搭 建 用 户 间 的 交流 通道 。 
1. 玩 法 说 明 


(1) 云端 扫描 : 找 趣 提供 直接 识别 的 形式 ， 即 刻 扫 描 图 片 ， 就 能 查看 AR 效果 (识别 图 ) 或 者 打开 对 应 的 项 目 (项 目 封面 图 ) 。 需 要 将 识别 图 或 封面 图 分 享 到 云端 。 


(2) 热门 推荐 : 页 面 下 提供 了 大 量 的 项 目 入 口 ， 包 括 官方 推荐 和 用 户 的 热门 频道 ， 只 要 点 击 图 片 ， 就 能 快速 打开 、 碍 看 项 目 内 的 场景 。 项 目 和 项 目下 的 识别 图 都 可 以 进行 分 享 。 
2. 查 看 说 明 


使 用 找 趣 查看 AR 效果 分 为 三 步 : 


(1) 准备 另 一 台 设 备 ， 打 开 识 别 图 ; 或 者 将 识别 图 打印 出 来 (不 要 使 用 反光 或 者 有 漫 射 材质 的 纸张 打印 ) 。 


(2) 打开 找 趣 App， 进 入 对 应 的 项 目 。 


(3) 待 App 准 备 好 后 ， 将 手机 摄像 头 对 准 识别 图 ， 即 刻 体验 AR。 


在 移动 端 找 趣 App 上 打开 频道 有 四 种 不 同 的 方式 : 

(1) 在 云端 扫描 模式 下 直接 识别 项 目 封面 图 : 这 种 方式 需要 用 户 在 创建 项 目 时 打开 云端 扫描 属性 。 

(2) 扫描 项 目 二 维 码 : 在 后 台 的 项 目 页 面 下 ， 每 个 项 目 都 对 应 一 个 独一无二 的 二 维 码 ， 使 用 找 趣 App 提 供 的 二 维 码 扫 描 工具 扫描 ， 便 会 打开 该 项 目 。 
(3) 按 项 目 名 搜索 : 在 最 上 方 的 搜索 框 内 输入 项 目 名 称 ， 点 击 列表 内 的 项 目 即 可 打开 。 


(4) 登录 后 查看 : 使 用 找 趣 账号 登录 浏览 器 ， 进 入 “我 的 记录 ”， 在 我 的 页 面 可 以 看 到 账号 下 的 项 目 ， 同 时 还 可 查看 和 打开 收藏 的 频道 。 


在 “我 的 场景 ”页 面 下 可 以 看 到 用 户 制作 的 所 有 场景 ， 如 果 拥 有 多 个 项 目 ， 则 在 右 方 的 项 目 列表 里 选择 所 属 的 项 目 ， 或 者 在 搜索 框 内 输入 名 称 。 


点 击 场景 图 片 可 以 打开 所 属 项 目 二 维 码 以 及 场景 识别 图 。 


每 个 场景 下 方 都 有 四 个 功能 按钮 ， 分 别 为 茶 用 /启用 、 编 辑 、 数 据 统计 和 删除 操作 。 再 次 编辑 不 同 制作 方式 下 的 场景 时 ， 依 然 打 开 原 始 制作 状态 下 的 编辑 页 面 。 


在 “我 的 项 目 ” 页 面 下 可 以 看 到 用 户 创建 的 所 有 项 目 。 如 果 拥 有 多 个 项 目 ， 则 在 右 方 的 标签 栏 里 选择 项 目 对 应 的 标签 ,或 者 在 搜索 框 内 输入 名 称 。 


Bm s^ hl ÜN 


点 击 项 目 图 片 可 以 查看 项 目 详细 信息 以 及 项 目下 的 场景 识别 图 。 


每 个 项 目下 方 都 有 四 个 功能 按钮 ， 分 别 为 查看 频道 二 维 码 、 编 辑 频道 的 详细 信息 、 数 据 统计 和 删除 操作 。 


对 场景 和 项 目的 查看 次 数 进行 统计 分 析 ， 能 够 很 好 地 帮助 用 户 探寻 AR 更 深层 的 价值 。 


点 路 


找 趣 云 平台 提供 了 场景 和 项 目的 扫描 、 分 享 和 点 赞 数据 统计 ， 人 允许 自 定义 对 象 和 时 间 区 域 以 生成 统计 报表 ， 并 可 以 导出 -png 格 式 的 文件 。 
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事件 交互 是 AR 编辑 器 最 突出 的 新 功能 之 一 。 找 趣 提供 了 一 系列 囊 用 的 功能 选项 ， 用 户 可 以 依据 自己 的 需求 来 定义 功能 被 触发 的 时 机 。 


上 面 是 一 个 交互 式 场景 的 示例 : 识别 到 AR 对 象 以 后 ， 可 以 点 击 AR 对 象 来 打开 网 页 。 一 个 完整 的 “事件 交互 ”包含 两 个 部 分 : 


` 事件 设置 : 直接 对 AR 对 象 进行 操作 ， 用 来 触发 动作 ， 如 上 图 中 的 “点 击 图 片 ”。 


功能 设置 : 触发 后 反馈 另 一 个 交互 ， 如 上 图 中 的 “打开 网 页 o 


1. 事 件 交互 设计 


选中 一 个 AR 对 象 后 ， 界 面 右 侧 的 功能 设置 将 会 启用 。 
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功能 设置 里 罗列 了 一 部 分 常用 的 交互 功能 ， 以 “显示 /隐藏 ”动作 为 示例 ， 点 中 后 会 弹出 如 下 的 页 面 。 


TARI sen 


IgE: fn 


您 想 何 时 触发 此 功能 ? Ur 


HIBE ES 


B model-1 


RAA БЯ: 名 称 是 用 户 对 当前 功能 的 定义 ， 用 于 标志 当前 动作 。 


` 设置 动作 触发 时 机 : 触发 事件 的 设 定 ， 在 这 里 要 选 定 对 象 和 事件 。 


« 隐 FM А 


Ei 
hs 


. 选择 功能 实现 的 对 象 在 列表 内 勾 选 (可 多 选 ) 对 象 ， 并 选择 是 “显示 ” 


@ 


保存 后 ， 隐 藏 动作 的 事件 交互 就 设置 好 了 。 


' 模型 动画 控制 : 对 选 定 模型 的 选 定 动画 进行 打开 或 关闭 操作 。 
显示 /隐藏 : 显示 /隐藏 同一 张 识别 图 下 的 AR 对 象 ， 可 多 选 。 

| 自 定义 动画 : 选 定 的 AR 内 容 按 照 设 置 好 的 起 始点 、 结 束 点 和 动态 效果 进行 移动 ， 以 某 种 效果 的 形式 移动 到 结束 点 并 桂 续 一 段 时 间 。 
* 手势 管理 : 选 定 的 AR 内 容 允 许 / 禁 止 某 个 或 某 几 个 手势 操作 。 

| 图 文 信息 : 以 网 页 的 形式 打开 编辑 好 的 图 文 信息 ， 内 容 可 自 定义 。 
t 打开 网 页 : 使 用 系统 浏览 器 跳 转 到 设置 好 的 网 页 。 

. 音乐 : 播放 音频 文件 。 

` 在 线 视频 : 全 屏 播 放 设 置 好 的 在 线 视频 。 

` 定位 导航 : 打开 设 定好 的 地 图 坐标 。 

| 拨打 电话 : 调用 手机 的 打 电 话 功 能 ， 拨 打 设 置 好 的 电话 号 码 。 

° 打开 其 他 频道 : 跳 转 到 其 他 频道 ， 可 以 扫描 其 他 频道 内 的 AR。 
.发送 邮件 : 打开 默认 的 邮箱 面板 。 

` 发 送 短信 : 跳 转 到 系统 的 短信 界面 。 


° 定位 界面 : 设 定 后 的 AR 对 象 在 扫描 丢失 后 依然 会 出 现在 屏幕 上 。 


人 允许 设置 的 触发 时 机 类 型 如 下 : 

: 扫描 识别 到 : 使 用 App 扫 描 图 片 ， 出 现 模型 的 瞬间 触发 动作 (该 事件 无 需 触 发 对 象 ) 。 
| 扫描 识别 丢失 : 使 用 App 扫 描 图 片 ， 丢 失 模 型 的 瞬间 触发 动作 (该 事件 无 需 触 发 对 象 ) 。 
"点击: 用 户 使 用 App 扫 描 图 片 、 出 现 模型 后 ， 点 击 该 模型 以 触发 动作 。 


` 被 显示 /被 隐藏 显示 /隐藏 功能 发 生 完成 后 触发 功能 。 


* 被 移动 /被 旋转 /被 伸缩 ; 用 户 移动 /旋转 /伸缩 当前 模型 的 时 候 ， 或 者 由 于 其 他 AR 对 象 的 事件 导致 当前 模型 变化 的 时 候 便 会 触发 功能 。 
' 动态 加 载 完毕 : 设 定好 的 对 象 实 时 加 载 完毕 后 触发 功能 。 


' 模型 动画 开始 /暂停 /停止 : 模型 对 象 的 动画 操作 发 生变 化 时 触发 功能 。 


12.8 ”模型 动画 的 播放 

制作 模型 类 AR 的 时 候 ， 常 常会 给 模型 添加 一 系列 的 动作 使 整个 AR 效果 更 加 精彩 。 不 过 使 用 AR 编辑 器 的 时 候 ， 模 型 的 动画 可 以 通过 互动 来 控制 ， 这 在 设置 上 要 复杂 一 些 ， 但 是 AR 的 可 玩 性 和 互动 性 得 到 
了 极 大 的 提高 。 

为 了 制作 带 有 动画 效果 的 模型 ， 需 要 在 AR 内 容 属性 列表 中 将 动画 添加 至 系统 。 未 匀 选 “自动 播放 ”的 模型 动画 ， 可 以 由 “动作 : 模型 动画 ”来 触发 ， 另 外 ，“ 动 作 : 模型 动画 ”也 可 以 控制 模型 动画 的 
暂停 和 停止。 
us: 


找 趣 支持 .fbx 和 .obj 格 式 的 模型 ， 但 FBX 格 式 的 文件 在 编辑 器 中 无 法 看 到 贴图 ， 使 用 App 扫 描 识 别 时 则 无 影响 。 


设置 方法 : 
— AES 
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切换 功能 设置 
“动作 : 模型 动画 ”。 


О EB IE ЕНЕ Л; 


EXE ШВЕИ 


JJ iË ¿p wok d. em 
异型 名， 动画 操作 ， 


| Ө 0н 


动画 名 (默认 Take р 


动作 设置 : 模型 动画 的 动作 属性 需要 填写 三 个 关键 变量 ; 模型 对 象 ; 动画 的 播放 / 特 停 /停止 操作 ; 输入 需要 播放 的 动画 名 称 。 
触发 时 机 :任意 AR 内 容 的 任意 事件 都 可 以 作为 触发 事件 。 
ug: 


添加 模型 动画 时 ， 动 画 的 名 字 一 定 要 与 模型 内 置 的 英文 动画 名 一 致 ; 模型 动画 暂停 后 ， 需 要 再 次 单独 设置 事件 - 动作 来 触发 动画 的 开始 播放 ， 而 不 能 通过 原 有 事件 来 控制 ; 由 模型 软件 直接 导出 的 .fbx 格 
式 文件 会 带 有 一 个 整体 的 动画 名 (Таке 001) ， 如 果 需 要 分 割 则 需 做 相关 处 理 。 


到 此 ， 找 趣 浏 览 器 的 学 习 就 告 一 段落 了 ， 更 多 有 趣 的 功能 还 有 待 大 家 的 进一步 发 现 ， 希 望 大 家 可 以 发 挥 想 象 力 ， 使 用 找 趣 定制 出 更 炫 更 酷 的 AR 应 用 。 


二 部 分 VR 开 友 


` 第 13 章 VR 技术 简介 

` 第 14 章 ”基于 Google Cardboard 开 发 VR 应 用 
第 15 章 ”基于 HTC Vive 开 发 VR 应 用 

. 第 16 章 ”基于 HTC Vive 实 现房 间 漫游 

- 第 17 章 ”基于 HTC Vive 开 发 投篮 游戏 


. 第 18 章 ”其 他 VR 设备 简介 


第 13 草 VR 技术 简介 


虚拟 现实 (Virtual Reality, VR) 简称 虚拟 技术 ， 也 称 虚 拟 环境 ， 是 利用 电脑 模拟 产生 一 个 三 维 空间 的 虚拟 世界 ， 提 供 关 于 视觉 等 感官 的 模拟 ， 让 用 户 感觉 仿 佛 身 临 其 境 ， 可 以 及 时 、 没 有 限制 地 观察 
三 维 空间 内 的 事物 。 用 户 进行 位 置 移动 时 ， 电 脑 可 以 立即 进行 复杂 的 运算 ， 将 精确 的 三 维 世 界 视频 传 回 以 产生 临场 感 。 该 技术 集成 了 计算 机 图 形 、 计 算 机 仿真 、 人 工 智能 、 感 应 、 显 示 及 网 络 并 行 处 理 等 技 
术 的 最 新 发 展 成 果 ， 是 一 种 由 计算 机 技术 辅助 生成 的 高 技术 模拟 系统 。 


在 著名 科幻 作家 刘 慈 欣 的 长 篇 小 说 《三 体 》 中 ， 有 一 套 可 穿戴 设备 叫 作 “V 装 具 ”， 是 《三 体 》 游 戏 玩家 所 使 用 的 设备 ， 在 小 说 中 是 这 样 描述 这 套 设备 的 : 


汪 铬 敲 门 ， 门 没 锁 ， 开 了 一 个 缝 ， 他 看 到 申 玉 菲 正 坐 在 电脑 前 玩 游戏 ,， 令 汪 铬 惊奇 的 是 她 竞 穿 着 一 套 “V 装 具 ”。 这 是 目前 在 游戏 玩家 中 很 流行 的 玩意 儿 ， 由 一 个 全 视角 显示 头盔 和 一 套 感 应 服 构 成 ， 
感应 服 可 以 使 玩家 从 肉体 上 感觉 到 游戏 中 的 击 打 、 刀 刺 和 火烧 ， 能 产生 出 酷热 和 严寒 ， 黄 至 还 能 逼真 地 模拟 出 身体 暴露 在 风 雪 中 的 感觉 。 


上 述 文字 很 好 地 摘 述 了 VR 技 术 未 来 的 发 展 方向 ，VR 不 但 能 给 用 户 带 来 视觉 冲击 ， 还 应 当 能 给 用 户 带 来 触觉 、 嗅 觉 等 其 他 感官 的 全 新 体验 。 从 目前 VR 设 备 的 发 展 来 看 ， 我 们 只 是 解决 了 其 中 很 小 的 一 部 
分 问题 ， 未 来 还 具有 很 大 的 发 展 空间 。 


近 几 年 ，VR 技 术 火 速 发 展 ， 并 诞生 了 很 多 VR 相关 硬件 以 及 设备 ， 这 些 设备 主要 分 为 主机 设备 和 移动 设备 ， 主 机 设备 以 以 下 三 种 设备 最 受 关注 。 


(1) Oculus 是 Facebook 在 2014 年 7 月 宣布 以 20 亿 美元 的 价格 收购 的 VR 设 备 制作 商 ， 在 Facebook 看 来 ，Oculus 的 技术 开辟 了 全 新 的 体验 和 可 能 性 ， 不 仅 在 游戏 领域 ， 还 在 生活 、 教 育 、 医 疗 等 诸多 领 
域 拥 有 广阔 的 想象 空间 。 


(2) HTC Vive 是 由 HTC 与 Valve 联合 开发 的 一 款 VR 头 显 产 品 ， 于 2015 年 3 月 在 MWC2015 上 发 布 。 由 于 有 Valve 的 steamVR 提 供 的 技术 支持 ， 因 此 在 Steam 平台 上 已 经 可 以 体验 利用 Vive 功 能 的 虚拟 现 
实 游戏 。 


(3) PS VR 是 索尼 推出 的 VR 头 显 ， 基 于 PSs4 主 机 的 平台 ， 玩 家 可 以 玩 到 丰富 的 VR 内 容 。 在 2016 年 的 E3 发 布 会 上 ， 索 尼 也 公布 了 包括 《最 终 幻 想 15》 在 内 的 一 系列 Ps VR 作品 ， 满 足 了 玩家 的 期 待 。 


有 不 少 人 认为 ， 与 手机 搭配 的 移动 VR 设 备 才 是 未 来 VR 的 发 展 方向 ， 因 此 有 很 多 厂商 也 发 布 了 他 们 的 移动 端 VR 设 备 。 


(1) Google Cardboard 最 初 是 谷歌 法 国 巴黎 部 门 的 两 位 工程 师 大 卫 : 科 兹 (David Coz) 和 达 米 安 .亨利 (Damien Henry) 的 创意 。 他 们 利用 谷歌 “20% 时 间 ” 规 定 ， 花 了 6 个 月 的 时 间 打 造 出 这 个 实 
验 项 目 ， 意 在 将 智能 手机 变 成 一 个 虚拟 现实 的 原型 设备 。 


(2) Gear VR 又 名 三 星 Gear VR， 是 三 星 推出 的 一 款 VR 头 显 ， 用 户 必须 有 一 台 配 套 的 三 星 Galaxy Note 4 手机 ， 并 确保 它 的 系统 升级 到 最 新 版 本 ， 最 后 用 户 必须 把 Gear VR 附带 的 16G microSD 卡 插入 
手机 中 ， 因 为 这 款 产品 需要 Note 4 作为 显示 屏 才 能 提供 相关 的 体验 。 


基于 移动 手机 的 VR 设 备 还 有 很 多 ， 我 们 在 此 不 一 一 列举 ， 在 本 书 ， 我 们 采用 Unity 3D3 引 擎 讲解 VR 产品 的 开发 。 关 于 硬件 平台 ， 移 动 端 VR 设 备 我 们 主要 选择 基于 Google Cardboard 进 行 技术 讲解 ， 这 
也 是 充分 考虑 到 谷歌 纸 盒 的 价格 非常 平民 化 ， 每 个 人 都 能 够 轻易 获取 ， 再 加 任意 一 台 智 能 手机 就 可 以 进行 开发 和 测试 了 。 其 他 移动 VR 应 用 开发 的 原理 与 Google Cardboard 类 似 。 


另外 ， 本 书 将 重点 讲解 基于 HTC Vive 开 发 VR 产品 ， 详 细 说 明 HTC Vive 中 手柄 事件 的 获取 及 处 理 ， 并 附带 开发 案例 ， 希 望 能 给 大 家 的 学 习 和 工作 提供 帮助 。 


本 书 最 后 还 简单 介绍 了 其 他 VR 设 备 的 一 些 知识 作为 参考 。 
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(1) 下 载 并 安装 Unity (本 书 采 用 Unity 5.3.4f1 版 本 ) 。 


(2) 通过 以 下 链接 下 载 Cardboard SDK for Unity 软 件 包 : 


ad/15040/OERDS 
ed/15940/OEBPS, 


(3) 通过 以 下 链接 下 载 Cardboard for Unity 演 示 场 景 : 


| 
htt pbs.//gl thub.con 1/9009 lesampleshtt 


(4) 打开 Unity， 创 建 一 个 新 项 目 ， 名 称 为 CardboardDemo。 


(5) 导入 SDK 软 件 包 : Assets 一 ImportPackage 一 Custom Package。 选 择 Cardboard SDKForUnity.unitypackage 下 载 软件 包 并 点 击 Open。 确 保 已 义 选 ImportingPackage 对 话 框 中 的 所 有 复 选 
框 ， 点 击 Import。 


如 果 你 使 用 的 是 Unity 5， 系 统 会 警告 API 将 自动 升级 。 如 果 出 现 上 述 警告 ， 请 接受 它 并 继续 操作 。 


(6) 导入 演示 软件 包 : Assets 一 Import Package 一 Custom Package。 重 复 上 述 步骤 ， 这 次 选择 CardboardDemoForUnity unity package。 在 编辑 器 的 Project 窗 格 中 ， 导 航 至 
Assets 一 Cardboard 一 Demoscene 文 件 夹 ， 然 后 打开 DemosScene。 你 应 该 能 够 看 到 这 样 的 一 个 场景 ， 在 贴 有 纹理 的 网 格 平面 上 漂浮 着 一 个 立方 体 。 


(7) 按 Play， 你 会 看 到 一 个 游戏 视图 ， 上 面 显示 呈现 立体 感 的 红色 立方 体 。 在 播放 模式 中 ， 按 Alt 并 移动 鼠标 可 沿 水 平方 向 和 垂直 方向 平移 ， 从 而 模拟 头 部 移动 。 使 用 Ctrl 模拟 头 部 从 一 边 向 另 一 边 倾 
#4. 


使 用 鼠标 +Alt 键 模拟 头 部 移动 。 


使 用 鼠标 + Ctrl 键 模拟 头 部 倾斜。 


焦点 选中 后 变 大 ， 并 且 被 选中 的 立方 体 变 成 绿色 。 


构建 Unity Project 的 步骤 如 下 : 
(1) 转 到 File 一 Build Settings， 打 开 Build Settings。 
(2) 在 Platform 下 选择 iOS， 然 后 点 击 Switch Platform 按钮 。 
(3) 点 击 PlayerSettings}#J 开 Inspector 中 的 PlayerSettings 面 板 。 
(4) 在 PlayerSettings 中 ， 在 iOS 设 置 的 底部 ， 点 击 Resolution and Presentation 可 展开 该 面板 ， 然 后 将 Default Orientation 设 为 Landscape Left, 


(5) 点 击 Other Settings 以 展开 该 面板 ， 并 查找 Bundle Identifier 字段 。 为 应 用 输入 有 效 的 软件 包 名 称 (如 com.mycompany.cardboarddemo) ， 该 名 称 须 遵循 java 软 件 包 和 .Net 命 名 空间 的 命名 规 


则 。 该 名 称 格式 通常 为 com.<yourcompany>.<appname>。 
(6) 点 击 Build， 系 统 会 提示 你 保存 名 称 ， 并 在 [您 的 Unity 项 目 ]/[ 您 的 保存 名 称 ] 目 录 中 准备 一 个 XCode 项 目 ， 我 们 将 该 项 目 部 署 到 iPhone。 
在 XCode 中 部 署 项 目的 步骤 如 下 : 


(1) 打开 XCode， 从 File 一 Openhttp://www.hzcourse.comy/resource/readBook?path=/openresources/teach_ ebook/uncompressed/15940/OEBPS/Text/... 菜 单 中 打开 你 创建 的 XCode 项 目 。 
它 将 成 为 你 在 上 一 个 部 分 刚 保存 的 目录 中 名 为 Unity-iPhone.xcodeproj 的 文件 。 


(2) 点 击 Unity-iPhone 项 目 并 选中 它 。 
(3) 在 项 目 菜单 栏 中 ， 点 击 Build Phases 以 打开 该 部 分 。 


(4) 展开 Link Binary With Libraries 列 表 。 


EH < у | [Bj unty-iPnone ICA» 
L] "D Unity-iIPhone 3 General Capabilities Build Settings Build Phases Build Rules 
ij 


Target Dependencies (0 items) 
Copy Bundle Resources (5 items) 
Run Script 

Copy Files (0 егте) 

Compile Sources (46 tama) 


Link Binary With Libraries (69 Items} 


(4) 


(5) 点 击 Link Binary With Libraries 列 表 最 底部 的 “+”。 这 将 打开 一 个 窗口 ， 上 面 显示 “Choose frameworks and libraries to add" (选择 要 添加 的 框架 和 库 ) , 


(6) 对 于 Unity 5.1.1 之 前 的 版 本 ， 在 搜索 框 中 输入 CoreText， 出 现 CoreText.framework 时 ， 双 击 它 以 将 其 添加 到 库 中 。 
(7) 如 果 一 切 进 展 顺 利 ， 你 应 该 会 看 到 “Build Succeeded” ， 并 且 Cardboard 演 示 版 将 在 iPhone 上 启动 ! 


f. 
JA: 


在 XCode 中 ， 你 可 能 会 遇 到 一 个 构建 错误 ， 显 示 “Multiple build commands to output file[yourproject]resources.bundle” 。 如 果 看 到 此 错误 ， 表 明 你 可 能 有 第 二 个 构建 指令 。 在 Xcode 项 目的 Build Phases 部 分 
p p tproJ 


中 ， 有 一 个 名 为 Copy Bundle Resources 的 部 分 ，resources.bundle 已 出 现 两 次 ， 删 除 其 中 的 一 个 。 


3.Android 平 台 的 发 布 和 设置 
(1) 在 File 一 Build Settings 中 选择 Android 作 为 平台 。 


(2) 点 击 Player Settings, Œ “Other Settings” 下 面 将 软件 包 名 称 输入 “Bundle Identifier” E (例如 ，com.example.CardboardUnityDemo) 。 在 “Resolution and Presentation” 下 面 检 
查 默 认 方向 是 否 设 为 “Landscape Left" , 


(3) 点 击 Build and Run。 如 果 系 统 提示 输入 Android SDK 的 位 置 ， 请 选择 已 解压 的 SDK。 


(4) 将 导出 的 apk 文 件 安装 至 Android 系 统 手 机 中 ， 打 开 应 用 ， 揪 入 Cardboard 即 可 。 


第 14 章 ”基于 Google Cardboard 开 发 VR 应 用 


14.1 Cardboard SDK for Unity 环 境 配置 


本 节 将 逐步 介绍 如 何 构建 和 部 署 Cardboard SDK for Unity 中 附带 的 演示 场景 。 
1.SDK 和 演示 场景 的 导入 和 运行 

(1) 下 载 并 安装 Unity (本 书 采 用 Unity 5.3.4f1 版 本 ) 。 
(2) 通过 以 下 链接 下 载 Cardboard SDK for Unity 软 件 包 : 

https://github.com/googlesampleshttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15940/OEBPS/Text/...itypackage?raw true, 
(3) 通过 以 下 链接 下 载 Cardboard for Unity 演 示 场 景 : 

https://github.com/googlesampleshttp://www.hzcourse.com/resource/readBook? path = /openresources/teach ebook/uncompressed/15940/OEBPS/Text/...itypackage?raw true, 
(4) 打开 Unity， 创 建 一 个 新 项 目 ， 名 称 为 CardboardDemo。 


(5) 导入 SDK 软 件 包 : Assets 一 ImportPackage 一 Custom Package。 选 择 Cardboard SDKForUnity.unitypackage 下 载 软件 包 并 点 击 Open。 确 保 已 勾 选 ImportingPackage 对 话 框 中 的 所 有 复 选 
框 ， 点 击 Import。 


f... 
JA: 


如 果 你 使 用 的 是 Unity 5， 系 统 会 警告 API 将 自动 升级 。 如 果 出 现 上 述 警告 ， 请 接受 它 并 继续 操作 。 


(6) 导入 演示 软件 包 : Assets 一 Import Package 一 Custom Package。 重 复 上 述 步骤 ， 这 次 选择 CardboardDemoForUnity unity package。 在 编辑 器 的 Project 窗 格 中 ， 导 航 至 
Assets 一 Cardboard 一 Demoscene 文 件 夹 ， 然 后 打开 Demoscene。 你 应 该 能 够 看 到 这 样 的 一 个 场景 ， 在 贴 有 纹理 的 网 格 平面 上 漂浮 着 一 个 立方 体 。 


(7) 按 Play， 你 会 看 到 一 个 游戏 视图 ， 上 面 显示 呈现 立体 感 的 红色 立方 体 。 在 播放 模式 中 ， 按 Alt 并 移动 鼠标 可 沿 水 平方 向 和 垂直 方向 平移 ， 从 而 模拟 头 部 移动 。 使 用 Ctrl 模拟 头 部 从 一 边 向 另 一 边 倾 


#4. 


使 用 鼠标 +Alt 键 模拟 头 部 移动 。 


使 用 鼠标 + Ctrl 键 模拟 头 部 倾斜。 


焦点 选中 后 变 大 ， 并 且 被 选中 的 立方 体 变 成 绿色 。 


2.iOS 平 台 的 发 布 和 设置 


构建 Unity Project 的 步骤 如 下 : 


(1) 转 到 File 一 Build Settings, #JJFBuild Settings, 

(2) 在 Platform 下 选择 iOS， 然 后 点 击 Switch Platform 按钮 。 

(3) 点 击 PlayerSettings}#J 开 Inspector 中 的 PlayerSettings 面 板 。 

(4) 在 PlayerSettings 中 ， 在 iOS 设 置 的 底部 ， 点 击 Resolution and Presentation 可 展开 该 面板 ， 然 后 将 Default Orientation 设 为 Landscape Left, 


(5) 点 击 Other Settings 以 展开 该 面板 ， 并 查找 Bundle 1dentifier 字 段 。 为 应 用 输入 有 效 的 软件 包 名 称 (如 com.mycompany.cardboarddemo) ， 该 名 称 须 遵循 Java 软 件 包 和 .Net 命 名 空间 的 命名 规 


则 。 该 名 称 格式 通常 为 com.<yourcompany>.<appname>。 
(6) 点 击 Build， 系 统 会 提示 你 保存 名 称 ， 并 在 [您 的 Unity 项 目 ]/[ 您 的 保存 名 称 ] 目 录 中 准备 一 个 XCode 项 目 ， 我 们 将 该 项 目 部 署 到 iPhone。 
在 XCode 中 部 署 项 目的 步骤 如 下 : 


(1) 打开 XCode,， 从 File 一 Openhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15940/OEBPS/Text/... 菜 单 中 打开 你 创建 的 XCode 项 目 。 
它 将 成 为 你 在 上 一 个 部 分 刚 保存 的 目录 中 名 为 Unity-iPhone.xcodeproj 的 文件 。 


(2) 点 击 Unity-iPhone 项 目 并 选中 它 。 
(3) 在 项 目 菜单 栏 中 ， 点 击 Build Phases 以 打开 该 部 分 。 


(4) 展开 Link Binary With Libraries 列 表 。 


HE < > | B unty-IPhona |< À > 
L] D Unity-iIPhane 3 General Capabilities Build Settings Build Phasas Build Rules 
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Target Dependencies (0 items) 
Copy Bundle Resources [5 items) 
Run Script 

Copy Files (0 егте) 

Complle Sourcea (46 Жета) 


Link Binary With Libraries (69 Items} 


(4) 


(5) 点 击 Link Binary With Libraries 列 表 最 底部 的 “+”。 这 将 打开 一 个 窗口 ， 上 面 显示 “Choose frameworks and libraries to add" (选择 要 添加 的 框架 和 库 ) , 


(6) 对 于 Unity 5.1.1 之 前 的 版 本 ， 在 搜索 框 中 输入 CoreText， 出 现 CoreText.framework 时 ， 双 击 它 以 将 其 添加 到 库 中 。 
(7) 如 果 一 切 进 展 顺 利 ， 你 应 该 会 看 到 “Build Succeeded” ， 并 且 Cardboard 演 示 版 将 在 iPhone 上 启动 ! 


fs. 
TER 


在 XCode 中 ， 你 可 能 会 遇 到 一 个 构建 错误 ， 显 示 “Multiple build commands to output file[yourproject]resources.bundle" 。 如 果 看 到 此 错误 ， 表 明 你 可 能 有 第 二 个 构建 指令 。 在 Xcode 项 目的 Build Phases 部 分 


中 ， 有 一 个 名 为 Copy Bundle Resoutces 的 部 分 ，tesoutces.bundle 已 出 现 两 次 ， 删 除 其 中 的 一 个 。 


3.Android 平 台 的 发 布 和 设置 
(1) 在 File 一 Build Settings 中 选择 Android 作 为 平台 。 


(2) 点 击 Player Settings, Æ “Other Settings” 下 面 将 软件 包 名 称 输入 “Bundle Identifier” FE (例如 ，com.example.CardboardUnityDemo) 。 在 “Resolution and Presentation” 下 面 检 
查 默 认 方 向 是 否 设 为 “Landscape Left" , 


(3) 点 击 Build and Run。 如 果 系 统 提 示 输 入 Android SDK 的 位 置 ， 请 选择 已 解压 的 SDK。 


(4) 将 导出 的 apk 文 件 安装 至 Android 系 统 手机 中 ， 打 开 应 用 ， 揪 入 Cardboard 即 可 。 


142 利用 Cardboard 创 建 VR 场 景 


本 节 将 介绍 如 何 使 用 Cardboard SDK for Unity 中 的 脚本 和 预制 件 结合 Unity 3D 创 建 自己 的 VR 场景 。 


1. 通 过 脚本 创建 VR 场景 


(1) 创建 新 的 项 目 并 导入 CardboardSDKForUnity.unitypackage 软 件 包 。 


(2) 新 建 场景 并 保存 为 Test。 
(3) 选择 Main Camera 并 将 脚本 StereoController.cs 附 加 到 MainCamera 上 。 
(4) 点 击 Play 将 会 看 到 如 下 效果 。 


(5) 在 层次 结构 面板 中 选择 摄像 头 (或 多 个 摄像 头 ) ， 然 后 执行 主 菜 单 命令 Component 一 Cardboard 一 Update Stereo Cameras。 此 命令 也 可 在 摄像 头 组 件 的 上 下 文 菜单 中 找到 : 在 Inspector 面 板 
中 找到 StereoController 脚 本 ,该 脚本 具有 UpdateStereo Cameras 按 钮 ， 点 击 可 将 立体 摄像 头 与 主 摄像 头 同 步 。 这 一 步 也 可 以 不 操作 ， 在 运行 时 程序 会 自动 执行 。 


їз 


2. 通 过 预制 件 创建 VR 场景 
除了 使 用 脚本 创建 VR 以 外 ， 还 可 以 使 用 Cardboard 预 制 件 〈 专 为 不 适合 采用 上 面 步 骤 的 情况 而 设计 ) 添加 VR。 


对 于 具有 单 目 摄像 头 的 全 新 项 目 ， 可 考虑 使 用 CardboardMain 预 制 件 替换 主 摄 像 头 。 此 预制 件 包 含 完 整 的 立体 影像 装置 ， 以 及 标记 为 MainCamera 的 摄像 头 和 一 个 用 于 控制 VR 模式 的 Cardboard 脚 本 
的 实例 。 


对 于 已 使 用 StereoController 脚 本 填充 的 现 有 项 目 ， 添 加 一 个 CardboardAdapter 预 制 件 作为 子 项 ， 这 会 将 CardboardHead 置 于 主 摄像 头 下 面 ， 从 而 使 用 户 的 头 部 运动 只 影响 到 立体 摄像 头 。 


14.3 Cardboard 中 GUI 的 设置 


在 开始 讲 GUI 设 置 之 前 ， 先 介绍 一 下 VR 场景 中 的 焦点 设置 。 
1.VR 场 景 中 的 焦点 设置 
(1) 在 Cardboard 一 Prefabs 一 UI 目录 下 ， 将 预制 件 CardboardReticle 放 置 在 Stereo Controller 脚 本 所 依赖 的 对 象 下 面 ， 作 为 StereoController 所 依赖 游戏 对 象 的 子 物体 。 


(2) 选择 新 拖 入 的 CardboardReticle 对 象 ， 并 将 材质 上 面 的 Color 属 性 设置 为 红色 ， 点 击 Play 即 可 看 到 下 图 的 效果 ， 也 就 是 在 VR 场景 中 添加 了 跟随 用 户头 部 运动 的 焦点 。 
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运行 后 位 于 屏幕 中 心 的 红色 焦点 如 下 所 示 。 


2.GUI 事 件 触发 
(1) 创建 button 按 钮 ， 在 Unity 中 通过 GameObject 一 UI 一 Button 创 建 一 个 button 按 钮 。 
(2) 选择 Canvas， 将 Render Mode 设 置 为 WordSpace， 并 调整 button 在 屏幕 中 的 位 置 。 


(3) 点 击 Play 后 将 会 在 VR 模式 下 看 到 镜头 中 的 UI 按钮 。 
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(5) 给 场景 中 的 EventSystem 对 象 添加 GazelnputModule 脚 本 ， 并 删除 其 上 的 Standard alone mudule 组 件 。 此 时 可 以 看 到 焦点 放 在 按钮 上 时 的 变化 。 


144 Cardboard 中 3D 物 体 的 选取 


(1) 按照 前 面 几 节 的 内 容 创 建 VR 场 景 和 焦点 。 为 了 与 场景 中 的 3D 对 象 交 互 ， 还 需要 将 PhysicsRaycaster 组 件 添加 到 Main Camera, 
(2) 在 场景 中 创建 一 个 Cube， 添 加 材质 并 设置 为 白色 ， 将 Cube 的 位 置 设置 到 屏幕 中 合适 的 地 方 。 
(3) 为 需要 选取 的 3D 对 象 Cube 添 加 碰撞 器 组 件 。 


(4) 新 建 Cube.cs 脚 本 ， 并 添加 如 下 代码 。 


public class Cube : MonoBehaviour 
{ 

public void GazeStart () 

{ 


GetComponent«Renderer» ().material.color = Color.blue; 


public void GazeExit() 


GetComponent«Renderer» ().material.color - Color.white; 


} 
} 


(5) 为 需要 选取 的 3D 对 象 Cube 添 加 EventTrigger 组 件 ， 并 添加 PointerEnter 和 PointerExit 两 种 事件 ， 分 别 调 用 Cube.cs 中 的 GazeSstart0 和 GazeExit() 方 法 。 


(6) 点 击 Play 则 会 看 到 如 下 效果 ， 焦 点 选中 Cube 时 变 为 蓝 色 。 


在 开始 本 节 内 容 前 需要 在 Photoshop 中 制作 如 下 图 标 。 
Ps P #80 ЕП БЕП) 文字 (Y) 选择 (5) 
Pi - 自动 选择 : ”组 显示 变换 控件 


i aze.png @ 10095(RGB/8) * х >> 
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(1) 根据 前 面 几 节 的 内 容 创建 一 个 VR 场景 ， 并 在 该 场景 中 创建 一 个 Cube。 


(2) 导入 预先 制作 好 的 图 标 ， 将 其 命名 为 gaze。 点 击 该 图 标 ， 在 Inspector 面 板 下 找到 Texture Type 属性 ， 将 其 设置 为 Sprite (2D and Ul) , 


@ Inspector 


Type 

Sprite Mode 
Packing Tag 
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Pivot 


Filter Mode 


Default 9 5 
Max Size | 2048 


Format | Compressed $ | 
| Revert || Apply 


Only POT texture can be compressed if 
mip-maps are enabled 

Only textures with width/height being 
multiple of 4 can be compressed to DXTS 
format 


(3) 创建 一 个 Image， 在 Unity 中 选择 GameObject 一 UI 一 Image 就 可 创建 一 个 mage。 在 Inspector 面 板 中 的 Image 组 件 中 找到 Source Image 属 性， 将 上 一 步 中 处 理 的 图 片 抱 动 到 该 属性 对 话 框 上 ， 
将 Image Type 设置 为 Filed， 调 整 lamge 到 合适 大 小 。 
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(4) 选择 Canvas， 在 Inspector 面 板 中 移 除 Canvas Scaler 和 Graphic Raycaster 两 个 组 件 ， 将 Canvas 组 件 的 Render Mode 设 置 为 World Space。 在 Hierarchy 面 板 中 将 Canvas 拖 动 到 Main Camera 


上 ， 使 其 作为 Main Camera 子 对 象 。 
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(5) 调整 Canvas 与 Main Camera 和 Cube 的 相对 位 置 ， 使 得 Canvas 和 Main Camera 的 位 置 坐标 中 PosX 和 PosY 相 等 或 者 相差 很 小 ， 调 整 Canvas 的 PosZ 使 图 标 gaze 出 现在 场景 中 并 处 于 Main 


Camera 和 Cube 之 间 。 


(6) 在 Hierarchy 面 板 中 选择 EventSystem 对 象 ， 在 Inspector 面 板 中 移 除 其 standalone Input Module 组 件 ， 在 Assets 面 板 下 选择 Cardboard 一 Scripts 一 Gaze Input Module， 将 其 拖 到 
EventSystem 对 象 上 。 


(7) 编写 脚本 GazeEventObject， 代 码 如 下 : 


using UnityEngine; 

using System.Collections; 
using UnityEngine.EventSystems; 
// 焦 点 进入 事件 

// 焦 点 退出 事件 


public class GazeEventObject : MonoBehaviour, IPointerEnterHandler, IPointerExitHandler 


{ 

// 焦 点 进入 的 委托 类 型 

public delegate void GazeEnter(); 
public static GazeEnter OnGazeEnter; 
// 焦 点 退出 的 委托 类 型 
public delegate void GazeExit(); 
public static GazeExit OnGazeExit; 
public void OnPointerEnter (PointerEventData eventData) 


if (OnGazel 


nter != null) í 
OnGazeEnl 


nter(); 


} 
} 
public void OnPointerExit (PointerEventData eventData) 


{ 


if (OnGazeExit != null) 


一 


= 


OnGazeExit (); 


(8) 编写 脚本 CubeEvent， 代 码 如 下 : 


using UnityEngine; 

using System.Collections; 

public class CubeEvent : MonoBehaviour { 
void Start () 


GazeObject.OnWaitEvent += OnWaitOver; 


void OnWaitOver () 


{ 
transform.Rotate (0, 60, 0); 


} 


(9) 将 脚本 GazeEventObject 和 CubeEvent 保 存 后 挂 载 到 Cube 对 象 上 。 


(10) 编写 脚本 GazeObject， 代 码 如 下 : 


using UnityEngine; 

using System.Collections; 
using UnityEngine.UI; 
public class GazeObject : MonoBehaviour 


{ 


public delegate void OnWaitTrigger(); 
public static OnWaitTrigger OnWaitEvent; 
public float WaitTime = 5; 

private bool start - false; 

private float timeGo = 0; 

// Use this for initialization 

void Start () 
{ 


GazeEventObject.OnGazeEnter += OnGazeEventEnter; 
GazeEventObject.OnGazeExit += OnGazeEventExit; 
start = false; 

timeGo = 0; 


// Update is called once per frame 
void Update () 
{ 


if (start) 


timeGo += Time.deltaTime; 

Image img = GetComponent«Image» (); 
img.fillAmount - 1 - (timeGo / WaitTime); 
if(timeGo » WaitTime) 

{ 


start = false; 
f(OnWaitEvent !- null) 


Iis 


{ 


OnWaitEvent (); 
timeGo = 0; 


} 


void OnGazeEventEnter () 


{ 


Start = true; 


void OnGazeEventExit () 


{ 


Image img = GetComponent«Image»(); 
img.fillAmount = 1; 
start = false; 


(11) 将 脚本 GazeObject 挂 载 到 Main Camera 一 Canvas 一 Image 对 象 上 ， 将 Wait Time 设 置 为 1。 
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(12) 点 击 运 行 ， 按 下 Alt 键 移动 鼠标 使 得 gaze (红色 图 标 ) 移动 到 立方 体 上 ， 等 待 1s 后 立方 体 旋转 ， 证 明 凝 视 触 发 操作 已 经 实现 。 


146 Cardboard 中 全 景 相册 的 实现 


这 一 节 我 们 使 用 谷歌 Cardboard 制 作 一 个 全 景 相册 ， 首 先 确 保 准 备 好 以 下 工具 : 
- Cardboard RR 45 o 
"5.1 以 上 版 本 的 Unity 编 辑 器 (本 书 使 用 5.3.4f1) 。 
5~8 张 全 景 图 片 。 
` 使 用 Max 等 三 维 软件 制作 的 一 个 法 线 向 内 的 球 。 


(1) 打开 Unity， 新 建 一 个 场景 ， 导 入 Cardboard SDK for Unity， 在 当前 场景 中 的 Main Camera 上 添加 脚本 StereoController， 点 击 StereoController 下 的 Update Stereo Camera， 按 照 下 图 进行 
操作 。 
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(2) 将 制作 好 的 法 线 向 内 的 球 拖 到 场景 中 ， 同 时 创建 一 个 脚本 ， 命 名 为 SphereGallary， 在 脚本 中 编辑 如 如 下 代码 并 保存 。 


using UnityEngine; 
using System.Collections; 
public class SpherGallery : MonoBehaviour { 
public Texture[] AllPhotos; 
int currentIndex - 0; 
public void OnNextButtonClick() 
Í 


Material mat = GetComponent<MeshRenderer> ().material; 
currentlndex++; 

if (currentIndex >= AllPhotos.Length) 

I 


) 


mat.mainTexture = AllPhotos [currentIndex]; 


currentIndex = 0; 


(3) 将 收集 到 的 全 景 图 片 拖 到 法 线 球 的 如 下 位 置 。 
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(4) 接 下 来 创建 一 个 按钮 (button) ， 然 后 在 调用 处 连接 这 个 脚本 。 


On Click () 
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(5) 在 连接 了 按钮 之 后 ， 点 击 运 行进 行 测试 ， 效 果 如 下 图 所 示 。 


(6) 导出 到 手机 ， 然 后 装 到 Cardboard 中 以 进行 观看 。 


14.7 Cardboard 中 全 景 视频 播放 的 实现 


Unity 中 的 视频 播放 插件 有 很 多 ， 常 用 的 有 MobileMovieTexture、VideoPlayback 和 EasyMovieTexture。 前 两 者 可 以 再 PC 上 运行 ， 但 是 需要 安装 QuickTime， 而 EasyMovieTexture 不 支持 PC 运行 ， 
可 以 在 移动 端 运行 ， 无 需 安装 QuickTime。Unity 默 认 文 持 的 视频 格式 分 别 有 .mov、.mpg、.mpeg、.mp4、.avi 和 .asf。 一 般 我 们 在 项 目 应 用 中 采用 .mp4 文 件 进行 视频 的 播放 。 在 本 节 中 ， 我 们 将 介绍 如 何 
使 用 Easy Movie Texture 来 实现 在 Andorid 手 机 上 播放 .mp4 格 式 的 全 景 视频 。 


在 开始 学 习 前 ， 需 要 准备 以 下 工具 : 
Cardboard 眼 镜 。 
.5.1 以 上 版 本 的 Unity 编 辑 器 〈 本 书 使 用 5.3.4f1) 。 
:一 张 全 景 图 片 和 一 个 .mp4 格 式 的 全 景 视 频 。 
` 使 用 max 等 三 维 软件 制作 的 一 个 法 线 向 内 的 球 。 
` Unity 视 频 播 放 插 件 EasyMovieTextute。 
(1) 根据 前 面 几 节 内 容 构建 VR 场景 。 
(2) 导入 揪 件 EasyMovieTexture、 制 作 好 的 法 线 向 内 的 球 和 全 景 图 片 。 为 导入 的 球体 制作 材质 球 ， 命 名 为 Sphere， 将 全 景 图 片 拖 到 Inspector 面 板 中 Albedo 前 面 的 方 框 内 。 


(3) 将 导入 的 球体 拖 到 Hierarchy 面 板 中 ， 并 把 材质 球 Sphere 赋 给 导入 的 球体 ， 在 Inspector 面 板 中 将 Sphere 下 的 Shader 设 置 为 Unlit 一 Texture。 


Assets 


Standard (Specular setup) 
Cardboard 
Chromakey 


(4) 在 Assets 面 板 中 将 全 景 视 频 拖 动 到 StreamingAssets 文 件 中 。 
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(5) 在 Assets 面 板 中 按照 路 径 EasyMovieTexture 一 Scripts 找 到 脚本 MediaPlayerCtrl 并 将 该 脚本 挂 载 到 导入 的 球体 上 。 在 Hierarchy 面 板 中 选中 导入 的 球体 ， 在 Inspector 面 板 中 找到 MediaPlayerCtrl 


组 件 ， 在 StrFileName 中 手动 填 入 “ 视 上 出 
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(6) 为 了 能 在 视频 播放 完毕 


页 名 .mp4” 


в horror 


(本 例 为 horror.mp4) ， 其 余 选 项 按 下 图 设置 。 
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后 在 Andriod 平 台 上 按 下 返回 键 使 得 程序 退出 ， 需 要 创建 脚本 ， 命 名 为 APP， 代 码 如 下 : 


MediaPlayerl 9 |) 
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using UnityEngine; 

using System.Collections; 

public class APP : MonoBehaviour { 
void Update () ( 


Application.Quit(); 
} 


if (Input.GetKeyDown (KeyCode.Escape)) { 


(7) 保存 场景 ， 将 该 场景 导出 成 apk， 安 装 到 Android 手 机 上 ， 点 击 运行 即 可 观看 。 


第 15 章 ”基于 HTC Vive 开 发 VR 应 用 


15.1 Vive 设 备 的 安装 
1. 设 备 检 查 
在 收 到 Vive 正 式 版 之 后 ， 先 检查 包装 盒 内 的 部 件 。 
: HTC Vive 主 机 ( 头 显 ) x1 
` 转 接 金 X1 
HDMI 数 据 线 X1 
. USB 转 换 线 X1 
- Lighthouse 3Ë 35 X 2 
: Steam VR Z Ж 5 8 | @ > 2 
` 控制 器 充电 器 X2 
` USB 充 电线 X2 
12V Lighthouse 基 站 电源 线 X2 
` 12V 接 线 鲍 电源 线 X1 
- Narrow Face 头 显 垫圈 X1 
Wide Face 头 显 垫圈 X1 
: Lighthouse 基 站 固定 架 X2 
. HTC 耳 机 X1 
` 使 用 手册 X1 


以 上 就 是 HTC Vive 包 装 盒 内 的 全 套 部 件 。 
2. 设 备 安装 


(Т) 将 转 接 盒 和 你 的 PC 通过 3.0 USB 接 口 连接 ， 同 时 连接 HDM I 数据 线 ， 转 接 盒 电 源 线 接 电源 。 


(2) 将 头 显 三 根 数 据 线 分 别 对 应 下 图 接口 连接 。 
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当 接 通 上 述 数 据 线 之 后 ， 如 果 头 显 左 侧 显 示 灯 变 红 ， 就 说 明 连 接 正确 。 


(3) 固定 两 个 Lighthouse 基 站 ， 原 装 设备 需要 固定 在 墙 上 ， 相 对 比较 麻烦 ， 也 可 以 配 一 对 摄像 机 专用 支架 来 进行 固定 ， 基 站 尽量 超过 地 面 2m 以 上 ， 且 向 下 倾斜 30"~50" 为 宜 。 


连接 好 基站 电源 线 之 后 ， 两 个 基站 会 显示 绿灯 ， 并 且 会 显示 当前 该 基站 所 处 的 频道 。 


(4) 打开 两 个 动作 控制 器 ， 把 它 和 头 显 放 在 两 个 基站 所 放 区 域内 。 


检查 上 述 硬件 设备 是 否 连 接 好 ， 查 看 各 设备 是 否 亮 绿灯 ， 如 果 全 都 没 问题 ， 下 面 进行 软件 平台 搭建 。 


3. 软 件 调试 


下 载 Steam 平 台 ， 在 Steam 平 台 的 工具 库 里 找到 SteamVR 组 件 并 下 载 安装 ， 安 装 好 之 后 点 击 运行 。 


在 启动 SteamVR 之 后 ， 它 会 自动 检测 当前 所 连接 的 设备 ， 如 果 所 有 设备 都 正常 连接 ， 则 显示 如 下 图 。 
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点 击 SteamVR 下 拉 菜 单 ， 选 择 房间 设置 : 


欢迎 来 到 房间 设置 ! 


设置 为 房间 规模 设置 为 仅 站 六 
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如 果 当 前 环境 有 足够 的 空间 ， 则 选择 房间 模式 进行 设置 ; 如 果 空 间 太 狭 容 ， 则 选择 站 立 模式 (这 里 选择 房间 模式 进行 调试 ) . 


腾 出 一 点 空间 。 


B5 , 请 在 两 个 定位 置 之 间 睹 出 一 
FIERI, 
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在 这 些 步骤 都 完成 之 后 ， 最 后 一 步 是 进行 范围 划 定 ，Vive 最 远 范 围 要 求 不 超过 5m。 


设置 您 的 游玩 范 国 . 
说 E 形 晤 示 的 是 适合 您 可 用 空间 的 
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当 这 一 步 完 成 之 后 ， 就 可 以 进行 Vive 体 验 了 。 
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15.1 Vive 设 备 的 安装 
1. 设 备 检 查 


在 收 到 Vive 正 式 版 之 后 ， 先 检查 包装 盒 内 的 部 件 。 


: HTC Vive 主 机 (Ж) х1 


-HEX 

. HDMIZC 2X, X1 

- USB 转 换 线 X1 

` Lighthouse 基 站 X2 

SteamVR 无 线 动 作 控 制 器 X2 

` 控制 器 充电 器 X2 

: USB 充 电线 X2 

12V Lighthouse 基 站 电源 线 X2 

` 12V 接 线 鲍 电源 线 X1 

- Narrow Face 头 显 垫圈 X1 

Wide Face 头 显 垫圈 X1 

: Lighthouse 基 站 固定 架 X2 

. HTC 耳 机 X1 

` 使 用 手册 X1 

以 上 就 是 HTC Vive 包 装 盒 内 的 全 套 部 件 。 
2. 设 备 安装 


(Т) 将 转 接 盒 和 你 的 PC 通过 3.0 USB 接 口 连接 ， 同 时 连接 HDM I 数据 线 ， 转 接 盒 电 源 线 接 电源 。 


(2) 将 头 显 三 根 数 据 线 分 别 对 应 下 图 接口 连接 。 
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当 接 通 上 述 数 据 线 之 后 ， 如 果 头 显 左 侧 显 示 灯 变 红 ， 就 说 明 连 接 正 确 。 


(3) 固定 两 个 Lighthouse 基 站 ， 原 装 设备 需要 固定 在 墙 上 ， 相 对 比较 麻烦 ， 也 可 以 配 一 对 摄像 机 专用 支架 来 进行 固定 ， 基 站 尽量 超过 地 面 2m 以 上 ， 且 向 下 倾斜 30"~50" 为 宜 。 


连接 好 基站 电源 线 之 后 ， 两 个 基站 会 显示 绿灯 ， 并 且 会 显示 当前 该 基站 所 处 的 频道 。 


(4) 打开 两 个 动作 控制 器 ， 把 它 和 头 显 放 在 两 个 基站 所 放 区 域内 。 


检查 上 述 硬件 设备 是 否 连 接 好 ， 查 看 各 设备 是 否 亮 绿灯 ， 如 果 全 都 没 问题 ， 下 面 进行 软件 平台 搭建 。 


3. 软 件 调试 


下 载 Steam 平 台 ， 在 Steam 平 台 的 工具 库 里 找到 SteamVR 组 件 并 下 载 安装 ， 安 装 好 之 后 点 击 运行 。 


在 启动 SteamVR 之 后 ， 它 会 自动 检测 当前 所 连接 的 设备 ， 如 果 所 有 设备 都 正常 连接 ， 则 显示 如 下 图 。 
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+ 添加 游戏 … 
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Ready 


点 击 SteamVR 下 拉 菜 单 ， 选 择 房间 设置 : 


欢迎 来 到 房间 设置 ! 


设置 为 房间 规模 设置 为 仅 站 六 
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如 果 当 前 环境 有 足够 的 空间 ， 则 选择 房间 模式 进行 设置 ; 如 果 空 间 太 狭 容 ， 则 选择 站 立 模式 (这 里 选择 房间 模式 进行 调试 ) . 


腾 出 一 点 空间 。 


B5 , 请 在 两 个 定位 置 之 间 睹 出 一 
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该 区 域 应 不 小 于 2 KR 1.5 
六 ,或 大 的 6.5 ARDS 
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这 些 步 又 都 完成 之 后 ， 最 后 一 步 是 进行 范围 划 定 ，Vive 最 远 范围 要 求 不 超过 5m。 
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当 这 一 步 完 成 之 后 ， 就 可 以 进行 Vive 体 验 了 。 


15.2 ”搭建 Vive 开 发 环境 


在 正式 开始 前 ， 先 确保 配备 有 以 下 硬件 设备 : 
: HTC Vive 完 整 设备 一 台 
` 操作 系统 : Windows 7 SP1, Windows 8.1, Windows 10。 
: 处 理 器 : Intel i5-4590, AMD FX 8350 X, vA E, 


“ 图 形 处 理 器 : NVIDIA GeForce GTX 970, AMD Radeon R9290 或 以 上 。 


如 果 以 上 硬件 设备 都 满足 了 ， 那 么 开始 我 们 的 下 面 的 旅程 。 


HTC Vive 是 由 HTC 与 Valve 共 同 开发 的 一 款 虚 拟 现实 头盔 产品 。 其 中 ， 由 于 Valve 的 SteamVR 提 供 技 术 支 持 ， 所 以 在 Steam 平 台 上 可 以 体验 利用 VIVE 功 能 的 虚拟 现实 游戏 。 
这 里 先 下 载 Steam 平 台 : http://store.steampowered.com/about/。 
在 下 载 安装 好 Steam 平 台 之 后 ， 开 始 下载 SteamVR， 在 “ 库 ”″ 一 “工具 ″′ 里 面 找 到 SteamVR 并 下 载 。 


当 SteamVR 下 载 好 之 后 ，Vive 的 运行 环境 就 算是 配置 好 了 。 


创建 一 个 新 的 工程 ， 然 后 打开 自 带 的 资源 商店 ， 搜 索 SteamVR Plugin 并 下 载 导入 ， 在 导入 之 后 ， 将 所 有 默认 的 GameObject 都 删除 ， 然 后 找到 如 下 文件 夹 中 的 Perfab， 全 部 拖 到 场景 中 。 
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在 做 好 这 些 准 备 工作 之 后 ， 就 可 以 戴 上 头盔 然后 点 击 运 行进 行 测试 了 。 

另外 ， 大 家 可 以 参考 steamVR Plugin 自 带 的 示例 场景 分别 在 下 面 这 些 路 径 下 : 
. SteamVR/Scenes/example 

- SteamVR/Extras/SteamVR_TestIK 


: SteamVR/Extras/SteamVR_TestThrow 


首先 打开 SteamVR 提 供 的 示例 场景 SteamVR_TestThrow， 在 该 场景 中 ， 当 你 扣 动 Trigger (手柄 扳机 键 ) 时 就 会 生成 一 个 球体 模型 ， 然 后 抛 出 去 。 
我 们 通过 这 个 示例 场景 来 制作 一 个 简单 的 投篮 游戏 。 


首先 找 一 些 资源 ， 比 如 篮球 架 、 篮 球 、 地 板 贴图 等 ， 然 后 导入 。 
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创建 一 个 Plane 的 材质 球 并 赋 给 当前 场景 中 的 Plane， 然 后 将 资源 中 的 Scenes 贴 图 贴 上 去 ， 并 调整 到 合适 位 置 。 


接 下 来 把 做 好 的 篮球 架 拖 到 场景 中 ， 并 放 到 合适 的 位 置 。 把 场景 中 的 Template 删 除 ， 然 后 拖 入 篮球 ， 并 做 如 下 改动 。 
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最 后 ， 给 篮球 创建 一 个 物理 材质 ， 命 名 为 basketball， 然 后 拖 到 篮球 上 。 
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这 一 步 ， 调 整 好 设备 ， 点 击 运行 以 测试 效果 。 


后 ， 导 出 为 .exe 文 件 ， 然 后 加 载 到 SteamVR 平 台 。 
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5 DE 
选 立 一 个 程序 并 将 其 添加 至 您 的 游戏 库 ， 


程序 < 
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15.4 Vive 中 的 手柄 交互 


在 Vive 游 戏 中 我 们 经 常会 用 手柄 去 触 碰 一 些 东 西 ， 然 后 和 它 交 豆 ， 那 么 这 个 功能 是 怎么 实现 的 呢 7 这 一 节 就 为 大 家 讲解 Vive 手 柄 触 碰 的 开发 。 


新 建 一 个 Unity 工 程 ， 导 入 steamVR 插 件 ， 找 到 [CameraRig] 这 个 预制 件 并 拖 到 场景 中 ， 同 时 把 场景 中 默认 的 照相 机 删除 ， 然 后 再 创建 一 个 Plane 和 一 个 Cube， 点 击 运行 进行 观察 。 


Fle Edt Assets GameObject Component Window Help 


«7 s 
BE > Q, El Cente 


在 Scene 界面 中 选中 其 中 一 个 动作 控制 器 (下 面 简称 手柄 ) ， 添 加 一 个 碰撞 器 ， 并 添加 刚体 ， 把 碰撞 器 调整 到 合适 大 小 。 


File Edit Assets GameObject Component Window Help 


创建 C# 脚 本 ， 改 名 为 MenuDevice， 并 写 入 如 下 代码 : 


public class MenuDevice : MonoBehaviour { 
void OnTriggerStay (Collider other) 


{ 
print (1231); 
} 
} 


将 脚本 拖 到 下 图 所 示 位 置 。 
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做 完 上 一 步 之 后 ， 点 击 运 行进 行 测 坛 ， 把 手柄 靠近 Cube， 然 后 看 输出 打印 。 


可 以 看 到 手柄 碰 到 了 Cube 并 且 输 出 了 我 们 所 规定 的 内 容 。 


接 下 来 我 们 实现 当 手 柄 靠近 并 且 扣 动 手柄 扳机 键 (Trigger) 的 时 候 Cube 会 被 拿 起 来 的 功能 。 


打开 前 面 创建 的 MenuDevice 脚 本 ， 写 入 如 下 代码 : 
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Unity (64bit) - menu.unity - Test - PC, Mac & Linux Standalone” «DX11» 


File Edit Assets GameObject Component Window Help 
"o n 


Asset Labels 


using UnityEngine; 
using System.Collections; 
public class MenuDevice : MonoBehaviour 


{ 


public SteamVR TrackedObject trackedObj; 
public GameObject Cube; 

bool isDrag-false; 

void Start () 


trackObject -this.GetComponent«SteamVR TrackedObject»(); 
} 
void Update () 
{ 


(isDrag == true) 


=~ H- 


Cube.transform.position = this.transform.position; 
Cube.transform.rotation = this.transform.rotation; 


} 


void OnTriggerStay (Collider other) 
{ 


// 获 得 设备 

SteamVR Controller.Device device = SteamVR Controller. Input ( (ini 

// 按 键 按 下 

if (device.GetTouch (SteamVR Controller.ButtonMask.Trigger) == 
isDrag = true; 

} 

else 

I 
isDrag = false; 


在 写 完 上 述 代 码 之 后 ， 在 Inspector 面 板 中 将 Cube 拖 到 相关 位 置 。 


true) 


L)trackedObj.index); 


{ 
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В Controller (right) (SteamvR Traci 
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15.5 ”功能 开发 之 扳机 键 (Trigger) 


Vive 扳 机 键 在 Vive 体 验 中 起 着 非常 关键 的 作用 ， 大 部 分 交互 工作 都 是 通过 扳机 键 来 触发 的 。 
(1) 下 载 SteamVR 揪 件 ， 创 建新 Unity 工 程 并 导入 。 


(2) 搭建 好 SteamVR 开 发 平台 。 
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(3) 创建 新 C# 脚 本 ， 起 名 为 VIVEFunctionTest， 把 该 脚本 分 别 拖 到 左右 摄像 头 上 ， 并 打开 进行 编辑 。 
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(4) 在 进行 手柄 Trigger 测 试 之 前 要 先 跟踪 到 手柄 。 


public class VIVEFunctionTest : MonoBehaviour 


{ 


SteamVR TrackedObject trackObject; 
// Use this for initialization 
void Start () 


trackObject -this.GetComponent«SteamVR TrackedObject»(); 


接 下 来 获取 具体 扣 动 扳机 的 手柄 ， 两 个 手柄 在 运行 的 时 候 ， 其 index 是 不 一 样 的 ， 这 里 就 是 通过 找到 不 同 的 index 来 找到 相应 的 手柄 。 


void Update () 
{ 


SteamVR Controller.Device device = SteamVR Controller. Input ((int)trackObject. 
index); 


} 


在 获取 到 具体 的 手柄 以 后 开始 测试 手柄 扳机 键 的 调用 。 


继续 在 void Update() 函 数 中 写 入 一 下 代码 ， 并 点 击 运 行进 行 测试 。 


f (device.GetHairTrigger ()) 


=~ H- 


Debug.Log ("GetHairTrigger"); 
} 


此 时 轻 轻 扣 动 扳机 ， 便 会 在 控制 台 看 到 输出 的 以 下 内 容 。 


5 65 
= = hus Чә me 


= Textures 
G VIVEButtonTest.cs 
B Console 


Collapse Clear on Play Error Pause 


GetHairTrigger 
UnityEngine.Debug:Log( Object) 


与 GetHairTrigger 同 类 型 的 还 有 两 种 形式 ， 分 别 是 GetHairTriggerDown 和 GetHariTriggerUp， 不 同 于 GetHariTrigger 的 持续 刷新 ， 这 两 个 函数 在 扣 动 扳机 时 候 只 会 调用 一 次 ， 将 这 三 种 函数 结合 起 来 
会 看 到 控制 台 输 出 如 下 内 容 。 


:= Hierarchy S Console 
Clear Collapse Clear оп Play Error Pause 


GetHairTriggerDown 
UnityEnaine.Debug:LoglObject) 


GetHairTrigger | 
UnityEngine.Debug:Log( Object) 


GetHairTriggerlLp 
UnityEngine,Debug:Log( Object) 


同时 ， 对 于 调用 手柄 扳机 键 还 有 第 二 种 方式 ， 叫 作 TouchDown()。 


注释 上 述 代码 ， 继 续 在 Update 函 数 中 写 入 以 下 代码 。 


if (device.GetTouchDown (Valve.VR.EVRButtonId.k EButton Axisl)) 
{ 


Debug.Log ("exportTrigger"); 


不 同 于 上 述 形式 ， 该 类 型 在 用 于 手柄 扳机 键 时 要 检测 一 次 完整 的 输入 ， 即 按 下 、 按 住 、 抬 起 。 


= Hierarchy B Console 
Clear Collapse Clear on Play 


E exportTrigger 
UnityEngine.Debug:Log( Object) 


同样 ，GetTouchDown 也 有 三 种 不 同 的 形式 ， 这 里 还 是 直接 看 输出 。 


汪 Hierarchy B Console 


mmm 
- 


lear Collapse Clearon Play Error Pause 


exportTriggerDown 
UnityEngine.Debug:Log(Object) 
exportTriager 
UnityEngine.Debug:Loag( Object) 


exportTriggerlLp 
UnityEngine.Debug:Log( Object) 


手柄 扳机 键 除 了 以 上 两 种 调用 形式 外 ， 还 有 第 三 种 调用 方式 。 
继续 在 Update 函 数 中 写 入 以 下 代码 。 
if (device.GetPress (Valve.VR.EVRButtonId.k EButton SteamVR Trigger)) 


Debug.Log ("ExportSteamVR Trigger"); 
) 


保存 后 点 击 运行 ， 会 有 如 下 内 容 输 出 。 


= Hierarchy B Console 
Clear Collapse Clear on Play 


ExportSteamVR Trigger 
LUinitrEngine,Debug:Log( Object) 


GetPress() 也 有 三 种 形式 ， 这 里 我 们 直接 输出 控制 台 。 


= Hierarchy B Console 
Clear Collapse Clear on Play Error Pause 
£k ExportSteamVR TriggerDown 
UnityEngine.Debug:Log( Object) 


gÈ ExportSteamVR Trigger 
UnityEngine.Debug:Log( Object) 


£h ExportSteamVR. TriggerlUp 
LUnityEngine.Debug:Log( Object) 


以 上 就 是 HTC Vive 手 柄 中 扳机 键 调用 的 三 种 方式 ， 下 面 总 结 一 下 扳机 相应 事件 : 
: GetHairTrigger() 
: GetTouch(Valve. VR. EVRButtonId.k EButton  Axis1) 


: GetPress(Valve. VR. EVRButtonld.k EButton SteamVR Trigger) 


Vive 手 柄 触摸 板 即 手柄 正 上 方圆 盘 ， 它 支持 两 个 功能 ， 滑 动 和 按 下 。 


类 似 于 扳机 键 的 调用 ， 在 脚本 开始 前 先 跟踪 调用 到 具体 发 射 指令 的 手柄 。 


SteamVR TrackedObject trackObject; 
void Start () 


trackObject -this.GetComponent«SteamVR TrackedObject»(); 


} 
void Update () 
{ 


SteamVR Controller.Device device = SteamVR Controller.Input ((int)trackObject.index); 


接 下 来 我 们 继续 在 Update 函 数 中 测试 触摸 板 的 功能 调用 。 


if (device.GetTouchDown (Valve.VR.EVRButtonlId.k EButton SteamVR Touchpad) ) 


Debug.Log ("TouchPadDown"); 


继续 写 入 如 上 代码 ， 然 后 点 击 运行 。 


Collapse Clearon Play Error Pause 


TouchPadDown | 
UnityEnaine.Debug:Log( Object) 


接 下 来 继续 使 用 GetPress() 来 实现 。 在 Update0 函 数 中 写 入 如 下 代码 并 检测 。 


if (device.GetPress (Valve.VR.EVRButtonId.k EButton SteamVR Touchpad)) 


Debug.Log ("GetPressTouchpad"); 
} 


控制 台 输 出 内 容 如 下 。 


= Hierarchy B Console 
Clear Collapse Clear on Play Error Pause 


@ф GetPressTouchpad 


触摸 板 按 下 也 可 以 用 下 面 的 方法 来 调用 : 


f (device.GetPress (Valve.VR.EVRButtonId.k EButton Axis0)) 


=~ H- 


Debug.Log ("ExportEButton Axis0"); 


控制 台 输 出 如 下 内 容 。 


= Hierarchy Console 
Clear Collapse Clear on Play Error Pause 


ExportEButton_Axis0 
UnityEngine.Debug:Log(ObJect) 


以 上 就 是 Vive 手 柄 圆 盘 的 按 下 功能 调用 ， 这 里 总 结 一 下 : GetTouch() 是 在 运行 时 轻 轻 点 击 即 可 触发 ， 而 GetPress0 则 需要 触摸 板 完 全 按 下 才能 检测 到 |。 


Vive 手 柄 触摸 板 可 以 在 特定 环境 下 进行 左右 或 者 上 下 滑动 来 与 物体 进行 交互 ， 这 里 我 们 讲解 如 何 调用 它 的 触摸 板 滑动 功能 。 


在 Update() 函 数 中 写 入 如 下 代码 : 


Vector2 FingerPosition- device.GetAxis (Valve.VR.EVRButtonId.k EButton Axis0); 
Debug.Log (FingerPosition); 


保存 之 后 点 击 运行 ， 在 触摸 板 上 轻 轻 滑动 手指 ， 控 制 台 就 会 输出 以 下 内 容 。 
| Em : 
= Hierarchy B Console 

Clear Collapse Clear on Play Error Pause 
(0.0, 0.0) 
UnityEngine.Debug:Log( Object) 

(0.2, -0.2) 
UnityEngine.Debug:Log( Object) 


[0.1, -0:2 
UnityEngine.Debug:Log(Ob]ject) 


(0.2, -0.3) 
UnityEngine.Debug:Log(Ob]ject) 
(-0.4, -0.4) 
UnityEngine.Debug:Log(Ob]Ject) 
(-0,5, -0.4) 
UnityEngine.Debug:Log( Object) 
[-0.5, -0.3) 
UnityEngine.Debug:Log( Object) 


259995595 


БЕ (0.0, 0.0) 表示 默认 是 在 触摸 板 中 心 点 ， 当 我 们 移动 手指 时 ， 触 摸 板 就 会 实时 记录 下 当前 手指 在 触摸 板 上 的 位 置 。 
触摸 板 为 平面 坐标 系 ， 坚 直 握 住 手柄 后 水 平 最 右 端 是 X 轴 最 大 值 +1， 坚 直 最 上 端 是 Y 轴 最 大 值 +1。 


以 上 就 是 Vive 触 摸 板 的 滑动 功能 。 我 们 来 总 结 一 下 : Vive 触 摸 板 滑动 功能 调用 k_EButton_Axis0 来 实现 ， 触 摸 板 X 轴 和 和 Y 轴 的 滑动 范围 都 是 (-1，+1) 。 


JJJB67T 2 C UJB6bE UNpplicauonivienu) 


Vive 手 柄 的 功能 键 是 指 在 触摸 板 上 边 的 一 个 键 ， 在 Vive 游 戏 开 发 中 一 般 用 来 弹出 游戏 菜单 等 。 


我 们 继续 在 Update 函 数 中 进行 功能 调用 ， 在 Update 中 写 入 以 下 代码 并 点 击 运 行 。 


f (device.GetPressDown (Valve.VR.EVRButtonId.k EButton ApplicationMenu)) 


=~ H- 


Debug.Log ("ExportApplicationMenu"); 


当 我 们 按 下 功能 键 的 时 候 ， 控 制 台 输 出 了 如 下 内 容 。 


法 Hierarchy | B Console 
Clear "Collapse Clear on Play Error Pause 


€ ExportApplicationMenu 


UnityEngine.Debug:Log(Ob]Ject) 


类 似 于 功能 键 这 种 只 需要 按 一 次 就 能 响应 事件 的 ， 我 们 都 用 Down 函 数 来 执行 。 


ВЕ 7 r ЛРЛКАЈ) (11 iggernap ticPu 15е) 


在 使 用 Vive 手 柄 进行 一 些 场景 交互 的 时 候 往 往 会 伴随 着 手柄 的 振动 ， 用 来 提示 使 用 者 当前 事件 已 经 处 于 可 触发 状态 。 


在 Vive 基 本 设备 调用 配置 正常 之 后 ， 在 脚本 中 写 入 以 下 代码 并 保存 : 


void Update () 
{ 


device.TriggerHapticPulse (500,Valve.VR.EVRButtonId.k EButton Ах150); 
Debug.Log (valve*Valve.VR.EVRButtonlId.k EButton Axis0); 


} 


其 中 ，device.TriggerHapticPulse() 就 是 控制 手柄 振动 的 函数 ， 该 函数 有 两 个 参数 ， 第 一 个 是 振动 的 幅度 大 小 ， 数 值 为 1~3999， 第 二 个 是 相关 的 振动 区 域 。 手 柄 目前 的 可 振动 区 域 分 别 是 手柄 整体 和 触 
ix (Touchpad) 处 ， 此 处 我 们 选用 手柄 触摸 板 为 振动 区 域 (如 果 忽 略 第 二 个 参数 ， 则 默认 为 手柄 整体 振动 ) ， 触 摸 板 在 Vive 底 层 的 ID 为 32， 如 下 图 所 示 。 


所 以 该 代码 在 运行 之 后 控制 台 会 输出 532。 接 下 来 点 击 运 行进 行 测试 。 


public enum EVRButtonId 

{ 
k EButton System = 8, 
k EButton ApplicationMenu - 1, 
k EButton Grip - 2, 
k EButton DPad Left - 5, 
К EButton DPad Up = 4, 
k EButton DPad Right - 5, 
k EButton DPad Down - 6, 
k EButton A = 7, 
k EButton Axis0 = 32, 
k EButton Axisl = 33, 
К EButton Ах152 = 34, 

k EButton Axis3 = 35, 


 EButton SteamVR 


k EButton SteamVR Trigger = 33, 
k EButton Dashboard Back = 2, 
k EButton Max = 64, 


= Hierarchy BH Console 
Clear Collapse Clear on Play Error Pause 


ap OpenVR initialized! 


UnityEngine.Debug:Log(Object) 


932 


UnityEngine.Debug:Log( Object) 


“b Connected to lighthouse:LHR-0A3095CC 


| éh Op enVR Shutdown 


15.9 ”功能 开 友 之 瞬 移 (Teleporter) 


Vive 瞬 移 就 是 在 场景 中 使 用 Vive 手 柄 进行 短 距离 快速 移动 ， 在 官方 游戏 案例 TheLab 中 可 以 看 到 ， 当 按 下 触摸 板 之 后 会 出 现下 图 所 示 效 果 。 


(1) 需要 下 载 制作 Vive 瞬 移 功 能 时 用 到 的 插件 ， 下 载 地 址 为 http://pan.baidu.com/s/1qYRDP16， 密 码 为 79g1。 


创建 一 个 新 的 Unity 工 程 并 导入 SteamVR， 将 下 载 好 的 瞬 移 插件 添加 到 Unity 场 景 中 。 


£3 Project 
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(2) 在 Unity 中 搭建 一 个 简单 的 场景 。 
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然后 点 击 菜单 栏 中 的 Windows 窗 口 ， 选 择 Navigation 功 能 ， 调 出 Unity 导 航 面 板 。 


= 


3ameObject Component [Window Help 


БЇ [семе есі — Next Window 


Previous Window 
Layouts 


Services 

Scene 

Game 
Inspector 
Hierarchy 
Project 
Animation 
Profiler 

Audio Mixer 
Asset Store 
Version Control 
Animator 
Animator Parameter 
sprite Packer 
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(3) 选中 地 面 ， 在 导航 面板 中 将 其 属性 设置 为 可 行走 区 域 ， 将 凸 起 的 三 个 立方 体 都 选中 ， 在 导航 面板 中 设置 其 属性 为 不 可 行走 区 域 ， 然 后 点 击 Bake 进 行 烘焙 泻 染 。 
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xt Unity Personal (64bit ; JELA $ < & L à al «s А s гүге" х=] 
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(4) 在 Vive-Teleporter 中 找到 Prefabs 文 件 夹 ， 并 将 其 中 的 两 个 预制 件 都 拖 到 场景 中 。 选 中 Pointer， 按 照 下 图 进行 操作 。 
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选择 CameraRig， 在 它 的 子 对 象 中 找到 Camera (eye) ， 选 中 并 在 Inspector 面 板 中 给 它 添加 Vive Teleporter 组 件 。 
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然后 将 所 需要 的 各 组 件 添加 到 Vive Teleporter 上 。 
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(5) 选择 Navmesh， 点 击 Update Navmesh Data 即 可 看 到 下 图 效果 。 


最 后 点 击 运 行进 行 测试 ， 效 果 如 下 图 。 
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1510 ”功能 开发 之 左右 侧 键 (Grip) 


Vive 手 柄 两 侧 各 有 一 个 按键 ， 称 为 侧 键 ， 形 状 如 下 图 。 


本 节 继 续 在 Update 遂 数 中 进行 功能 调用 。 在 Update 中 写 入 如 下 代码 : 


if (device.GetPress (Valve.VR.EVRButtonId.k EButton Grip)) 


I 
Debug.Log ("ExportGrip"); 


) 


相应 的 控制 台 输 出 内 容 如 下 。 


E rs Qu - 
m E love 
= [rilerarcnvy 临门 在 总 | 已 


Clear Collapse Clear оп Play Error Pause 


ExportGripDown 
UnityEngine.Debug:Log( Object) 


我 们 再 调用 另外 一 个 函数 ， 让 它们 同时 输出 ， 继 续 在 Update 中 写 入 代码 : 


if (device.GetPressDown (Valve.VR.EVRButtonId.k EButton Dashboard Back) ) 


Debug.Log ("ExportDashboard Back"); 


= Hierarchy BH Console 
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JAIEZ ARAH TFAAR ИРА Н, PAV ve FRA, РАИ АУ [а] — 1 TRE. 


以 上 就 是 Vive 手 柄 侧 键 的 功能 调用 。 


在 Vive 官 方 给 出 的 案例 游戏 中 有 一 款 叫 作 The Lab 的 游戏 集 广 受 欢迎 ， 很 多 人 在 初次 接触 到 Vive 时 就 被 The Lab 吸 引 ， 而 The Lab 的 独特 之 处 除了 游戏 方式 之 外 还 有 泻 染 器 。Vive 官 方 给 出 了 The Lab 中 
所 有 基于 Unity 体 验 的 技术 ， 并 且 免 费 供 开 发 者 使 用 。 


Unity 目 前 使 用 的 着 色 器 是 多 重 的 ， 每 次 光 点 点 亮 物体 时 ， 几 何 体 又 会 被 泻 染 一 次 。The Lab 泻 染 器 在 一 次 前 置 泻 染 中 最 多 支持 18 个 动态 阴影 光线 。 


在 Unity 资 源 商店 中 搜索 The Lab Renderer， 下 载 并 导入 。 


The Lab Renderer 
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ENI 
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(A W) T) S) PJ) 
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Valve's VR renderer used in The Lab (Valve's 
VR launch title for the HTC Vive). 


This is the set of scripts and shaders that 

drove rendering in The Lab. It is a forward | | | ^ c EZ 
renderer with support for up to 18 dynamic ЕЕЕ N 1 t 
shadowing lights in a single pass with MSAA h EN v 
enabled, and it included the Adaptive Quality VR ESS F NTI ALS a * 
system that dynamically adjusts rendering = p 
resolution to maintain framerate in VR. | z 


Ф `. 


导入 完成 之 后 选中 场景 中 的 主 摄像 机 ， 并 添加 脚本 Valve Camera， 人 在 当前 场景 的 烘焙 光源 上 添加 脚本 Valve Realtime Light， 完 成 之 后 在 菜单 栏 中 会 出 现 Valve 菜单 选项 。 
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点 击 即 可 将 场景 中 的 材质 转换 为 Valve 提供 的 Shader ( 代 蔡 Unity5 Standard Shard) 。 
相 较 于 Unity 提 供 的 演 染 设施 ，The Lab 泻 染 器 具有 以 下 一 系列 优点 : 


. 单 向 前 置 泻 染 和 多 重 采 样 抗 锯齿。 


- GPU 刷新 。 


第 16 草 ”基于 HTC Vive 实 现房 间 漫 游 


在 VR 技术 普遍 成 熟 之 后 ， 随 之 兴起 的 一 项 重要 内 容 就 是 VR 虚拟 房间 漫游 ， 目 前 国内 在 制作 虚拟 房间 漫游 时 主要 使 用 虚幻 游戏 引擎 (UE4) 和 Unity 3D 游 戏 引 擎 ， 本 节 主 要 使 用 Unity 3D 来 实现 房间 漫 
游 。 


161 准备 工作 


在 开始 制作 房间 漫游 之 前 ， 需 要 准备 以 下 内 容 : 

Unity 3D 游 戏 引 擎 ， 本 节 使 用 的 版 本 为 5.3.4f1， 建 议 保持 一 致 。 官 网 下 载 地 址 为 https://unity3d.com/cn/get-unity/download/archive_ga=1.67797329.116705845.1462463231 
- 基于 Unity 3D2$3X 5] SF &9SteamVR Plugs 组 件 ， 在 Unity3D 自 带 的 资源 商店 中 即 可 下 载 。 

电脑 显卡 不 低 于 GTX970， 并 且 安 装 了 Steam 游 戏 平 台 以 及 平台 内 的 SteamVR 组 件 。 


确保 SteamVR 正 常 工作 ， 并 设 定 了 房间 范围 (如 有 疑问 ， 可 参照 前 面 的 章节 ) 。 


S le army т 


.一 套房 间 模 型 。 


16.2 ”基本 平台 搭建 


新 建 一 个 Unity 3D 工 程 ， 命 名 为 VIVEHouse， 打 开 资 源 商店 搜索 下 载 SteamVR Plugs 并 导入 。SteamVR 组 件 是 Valve 公 司 专 为 Unity 3D 开 发 Vive 系 列 VR 游 戏 而 推出 的 ， 通 过 该 组 件 我 们 可 以 制作 出 各 
种 适用 于 HTV Vive 的 游戏 应 用 。 


导入 SteamVR Plugs 完 成 之 后 ， 将 场景 中 的 主 摄 像 机 删除 ， 同 时 把 如 下 图 所 示 的 预制 件 拖 到 场景 中 ， 该 预制 件 包含 Vive 头 友 显 示 器 (下 边 简称 头 显 ) 所 适用 的 专用 摄像 机 。 
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点 击 Unity 3D 运 行 按钮 ， 即 可 通过 头 显 摄像 机 看 到 Unity 3D 的 虚拟 世界 。 


E) Unity (64bit) - Untitled - VIVEHouse - PC, Mac & Linux Standalone“ <DX11> 
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163 ”导入 房间 模型 


将 准备 好 的 房间 模型 导入 Unity 3D 中 ， 本 节 导 入 的 模型 格式 为 .unitypackage， 除 此 之 外 ，Unity 3D 还 支持 “.fbx” 和“.obj” 格 式 的 模型 。 


打开 模型 自 带 的 场景 并 另存 一 份 ， 更 名 为 VIVEHouse。 


| Y. Favorites А Assets » Medieval House > Scene 
Ol All Materials Î Sš Sample_Scene 
(© All Models % Sample Scene 
(Ot All Prefabs 
(О All Scripts 


* 5S Medieval House 
ES Animations 
"53 Prefabs 
Buildings 
53 Nature 
zs Props | 
= Scene | 
Ыш Sample Scene 
Scripts 
"ES Source 
"5S Standard Assets 
"E: Plugins 


将 场景 中 的 如 下 游戏 对 象 删除 。 
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Door Opener 
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164 基于 Vive 手 柄 的 场景 移动 


一 般 的 Vive 游 戏 位移 分 为 两 种 。 一 种 是 跳跃 性 的 ， 即 通过 手柄 扳机 键 (Trigger) 将 摄像 头 移动 到 当前 选择 的 位 移 点 ， 从 而 实现 移动 。 该 位 移 方 法 主要 依赖 Unity 3D 的 Navigation 泻 染 地 形 从 而 获得 可 
移动 的 位 置 点 ， 其 优点 在 于 画面 稳定 、 有 眩晕 感 小 ， 缺 点 是 对 于 当前 地 形 的 平整 度 要 求 较 高 ， 地 形 坡度 不 能 超过 5*， 否 则 无 法 识别 到 位 置 点 。 另 一 种 就 是 通过 Vive 手 柄 触摸 板 (TouchPad) 滑动 来 进行 平滑 
位 移 ， 该 方法 的 优点 在 于 可 以 实现 复杂 场景 地 形 漫游 ， 不 用 规定 位 置 点 ， 移 动画 面 平 滑 度 较 高 ， 缺 点 则 是 如 果 移 动 速度 过 高 ， 则 会 出 现 眩晕 等 不 适应 症状 。 本 节 使 用 第 二 种 方式 来 实现 场景 位 移 。 


首先 将 SteamVR 中 的 头 显 摄像 机 拖 到 场景 中 ， 位 置 如 下 ， 并 进行 调整 。 


新 建文 件 夹 并 命名 为 Scripts， 在 其 中 新 建 一 个 C# 脚 本 ， 命 名 为 MoveController， 把 该 脚本 拖 到 场景 对 象 [CameraRig] 下 的 Controller (right) 上 ， 然 后 双击 打开 并 进行 编辑 。 
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脚本 编辑 的 第 一 步 是 获取 当前 发 送 位 移 请 求 的 设备 〈 即 获取 手柄 ) . 


public class MoveController : MonoBehaviour 

{ 
SteamVR TrackedObject trackedObject; 
void Start () 


{ 
trackedObject = this.GetComponent«SteamVR TrackedObject» (); 


] 
void Update () 
{ 


var device = SteamVR Controller.Input ((int)trackedObject.index); 


接着 获取 手柄 触摸 板 按 下 事件 ， 同 时 给 当前 物体 一 个 向 前 的 位 移 以 及 速度 。 


public class MoveController : MonoBehaviour 
{ 
public GameObject Obj; 
public float Speed-0.4f; 
void Update () 
{ 


if (device.GetPress (Valve.VR.EVRButtonId.k EButton SteamVR Trigger)) 
{ 


} 


Obj.transform.position += transform.forward * Speed; 


保存 代码 并 退出 ， 选 中 场景 中 的 [CameraRig]， 并 且 在 Inspector 面 板 中 点 击 添加 组 件 (AddComponet) ， 添 加 Rigibody 和 Box Collider， 具 体 配置 如 下 图 。 


选择 Controlle (right) 将 当前 速度 更 改 为 自身 所 适应 的 合适 速度 ， 在 空 出 的 Obj 栏 中 拖 入 [CameraRig] 对 象 。 
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接 下 来 点 击 运 行进 行 测试 ， 扣 动 扳机 键 时 ， 角 色 就 可 以 在 场景 中 移动 了 。 
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165 ”基于 Vive 手 柄 的 场景 旋转 


在 Vive 场 景 中 视角 旋转 分 为 两 种 ， 一 种 是 通过 获取 头盔 旋转 来 改变 当前 视角 ， 另 一 种 是 通过 手柄 控制 来 旋转 视角 ， 本 节 使 用 第 二 种 手柄 控制 来 旋转 视角 。 双 击 打开 MoveController 脚 本 进行 编辑 。 


首先 使 手柄 触摸 板 获取 手指 在 触摸 板 上 的 位 置 。 


void Update () 
{ 


float PosX =- device.GetAxis (Valve.VR.EVRButtonId.k EButton Ах150).х; 


然后 通过 判断 当前 手指 所 在 触摸 板 的 X 轴 的 正 负 来 控制 视角 的 左右 移动 。 


void Update () 

{ 

if (device.GetPress (Valve.VR.EVRButtonId.k EButton SteamVR Touchpad)) 
{ 


if (PosX « 0) 
{ 


Obj.transform.Rotate (100*Vector3.up*Time.deltaTime); 


} 
else if (PosX > 0) 


{ 


Obj.transform.Rotate (100*Vector3.down*Time.deltaTime); 
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166 FASTARE 


在 Scripts 文 件 中 新 建 一 个 C# 脚 本 并 命名 为 GController， 拖 到 Controller (left) 对 象 上 。 


1. 给 手柄 添加 碰撞 器 
在 编辑 脚本 之 前 首先 点 击 运行 场景 然后 点 击 暂停 ， 并 且 在 Scene 场景 中 居中 显示 Controller (left) 手柄 。 
点 击 Add Componet 添 加 一 个 Box Collider， 然 后 点 击 Collider， 将 其 碰撞 范围 缩小 到 合适 范围 。 


接 下 来 点 击 Collider 上 边 的 属性 设置 ， 点 击 复制 该 组 件 。 
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R) Unity (64bit) - VIVEHouse.unity - VIVEHouse - PC, Mac & Linux Standalone” «DX11» 
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Reset 


Remove Component 
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Controller Пећ) 


Paste Component Values 


停止 场景 运行 ， 然 后 再 次 选中 Controller (left) ， 将 刚才 复制 的 组 件 重新 添加 上 去 。 
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这 里 需要 了 解 的 是 ， 对 于 Unity 3D 在 运行 状态 下 所 编辑 的 内 容 ， 停 止 运行 Unity 3D 场 景 之 后 都 会 清除 掉 ， 所 以 一 般 对 于 场景 中 游戏 对 象 的 编辑 都 是 在 非 运行 状态 下 进行 的 。 这 里 需要 对 Vive 手 柄 添加 一 


个 Box 碰 撞 器 ， 但 是 手柄 只 有 在 运行 状态 下 才 会 出 现 ， 在 非 运行 状态 下 是 不 可 见 状 态 ， 所 以 我 们 需要 在 运行 时 给 手柄 添加 组 件 ， 同 时 将 其 复制 出 来 ， 然 后 待 场景 停止 运行 后 再 将 该 组 件 添加 上 去 。 


接 下 来 再 给 手柄 添加 一 个 刚体 (Rigibody) ， 并 按照 下 图 进行 配置 。 
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2. 给 场景 中 的 物体 添加 碰撞 器 
选择 场景 中 的 门 ， 并 且 给 门 的 钥匙 部 位 添加 一 个 础 撞 器 ， 同 时 给 门 设 定 一 个 标签 (tag) ， 命 名 为 Door， 同 时 取消 勾 选 Static 
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双击 打开 GController 脚 本 并 进行 编辑 。 


首先 获取 需要 交互 的 手柄 : 


public class GController : MonoBehaviour 


SteamVR TrackedObject trackedObject; 
void Start () 


trackedObject = this.GetComponent«SteamVR TrackedObject» (); 


然后 使 用 触发 器 来 判断 手柄 是 否 碰 到 场景 中 的 物体 : 


void OnTriggerStay (Collider other) 
I 


var device = SteamVR Controller.Input ((int)trackedObject.index); 

if (other.gameObject.tag == "Door") 

// 要 碰撞 的 物体 的 标签 为 Door 

{ 

if (device.GetPressDown (Valve.VR.EVRButtonId.k EButton SteamVR Trigger)) 

// 扣 动 扳机 键 来 触发 事件 
{ 


Animation anim-other.GetComponent«Animation»|(); 
anim.Play ();// 调 用 标签 为 Door 的 物体 的 动画 系统 并 播放 动画 


通过 以 上 步骤 我 们 就 实现 了 基于 Unity 3D 的 Vive 场 景 漫游 的 制作 。 


第 17 章 ”基于 HTC Vive 开 发 投篮 游戏 


17.1 ”准备 素材 


本 节 带 领 大 家 制作 一 个 简单 的 VR 投 段 游戏 ， 在 开始 之 前 我 们 需要 准备 一 些 素材 ， 比 如 篮球 架 、 篮 球 、 征 球场 地 贴图 等 。 


FBX | 


ballJpg lanqiu.FBX LanQiuJia.FBX scenesJpg 


在 Unity 3D 资 源 商店 下 载 HTC Vive 的 组 件 steamVR Plugs 并 导入 。 
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171 ”准备 素材 


本 节 带 领 大 家 制作 一 个 简单 的 VR 投 复 游 戏 ， 在 开始 之 前 我 们 需要 准备 一 些 素材 ， 比 如 篮球 架 、 征 球 、 复 球场 地 贴图 等 。 


FBX 


ballJpg lanqiu.FBX LanQiuJia.FBX scenesJpg 


在 Unity 3D 资 源 商店 下 载 HTC Vive 的 组 件 steamVR Plugs 并 导入 。 


17.2 场景 搭建 


1. 开 始 界面 的 制作 


在 开始 界面 中 ， 当 我 们 使 用 手柄 触 碰 到 开始 按钮 之 后 就 会 进入 投篮 的 游戏 场景 中 。 


在 场景 中 创建 一 个 Plane， 并 给 Plane 添 加 一 个 材质 球 ， 然 后 将 导入 的 floor 贴 图 贴 上 去 。 想 要 在 一 个 物体 上 添加 一 张 好 看 的 贴图 ， 首 先 要 给 该 物体 添加 一 个 材质 球 ， 然 后 再 把 贴图 附着 在 材质 球 上 面 。 


接 下 来 继续 创建 两 个 Cube， 作 为 开始 按钮 的 触发 界面 。 分 别 给 两 个 Cube 创 建材 质 球 ， 并 且 将 下 边 的 Cube 材 质 球 的 颜色 改 为 黄色 ， 上 边 的 Cube 材 质 球 的 颜色 改 为 红色 ， 位 置 关 系 如 图 所 示 。 
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做 完 这 一 步 后 ， 我 们 给 红色 Cube 添 加 一 个 可 以 用 手柄 来 触发 的 按钮 。 选 择 红色 Cube， 在 它 下 边 创建 一 个 Text， 此 时 在 红色 Cube 下 边 就 会 多 出 下 图 所 示 的 三 个 对 象 。 
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选择 Canvas 对 象 ， 将 该 对 象 的 泻 染 模式 改 为 世界 坐标 ， 然 后 重 置 其 位 置 ， 使 它 与 红色 Cube 需 要 显示 按钮 的 面 重合 。 
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修改 Text 上 边 的 文字 为 “开始 ”， 并 放 到 红色 Cube 的 中 间 位 置 。 


添加 如 下 图 所 示 的 预制 件 并 拖 到 场景 中 ， 该 预制 件 包含 Vive 头 盔 显 示 器 所 适用 的 专用 摄像 机 。 


W Start Cubel 
Q start Cube2 Rotation Хо — YO FAD | 
> Scale х(05558|үј17658|21 | 
Canvas Renderer 


Y Text (Script) 
Text 


W Scripts ~ ! i fü — 
= Hierarchy Soni Mais - ; 


свае ”| CFA) Character 
YÁ start* к= Font 
| Directional Light Font Style 
p [CameraRig] Font Size 
Floor Line Spacing 
v Cube Rich Text 
Y StartM Paragraph 
er Alignment 
Align By Geometr | | 
Horizontal Оуетћо мар 一 
Vertical Overflow 
Best Fit т 
Color 


к= == 
Material [None (Material) | © 


Layout Properties - 


| Create ”| Ес HE чп Ж. 
Б Materials А Asset Assets > SteamVR 


"k Medieval | - _ f [CameraRig] ` 
i P hg [Status] ` 
>ш сфе yi [SteamVR] 
"mires "7 | 

Resource 

= scene 

Script 

E Scripts 
"S Standarc 


= Te 
= Materi 
шй: [Caron 


Retation xis 25) 
sae — x: (jv: jz | 


Г SteamV Rerd б 


Create Comoonents м 
Upcate Dynaricaly Z 


= Hierarchy 
Lenze) (al) 
"4 Start* -= 
 Directenal Light | 
Y [CameraRig] 


Freeze Poston X Y | Z 
Freeze Rotaten JX Y Ut 


т Edt Cellider 


€ (Physic Mate G 


Center 
mua ишк 0.061094 
Size 


X/0.189€4 ¥ 0.14292 |2 0.326475] 


EvertSystem 


分 别 给 左右 手柄 控制 器 添加 刚体 和 碰撞 器 ， 并 调节 到 合适 的 位 置 和 大 小 。 


创建 两 个 C# 脚 本 ， 分 别 命名 为 StartM 和 LoadLevel， 将 StartM 脚 本 拖 到 红色 Cube 上 ， 将 LoadLevel 脚 本 拖 到 左右 手柄 模型 上 。 
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在 StartM 脚 本 中 写 入 以 下 代码 : 


public class StartM : MonoBehaviour 
public void OnButtonDown () 


{ 
Application.LoadLevel (1); 
} 


在 LoadLevel 脚 本 中 写 入 以 下 代码 : 


public class LoadLevel : MonoBehaviour 
{ 
public SteamVR TrackedObject trackedobject; 
// 获 取 当 前 的 触发 手柄 
void OnTriggerStay (Collider other) 
// 使 用 触发 器 来 判断 是 否 开 始 游戏 
{ 
StartM starbutton = other.GetComponent«StartM» (); 
£ (starbutton !- null) 
{ 
SteamVR Controller.Device device-SteamVR Controller.Input ((int)trackedobject.index); 
if (device.GetTouchDown (SteamVR Controller.ButtonMask.Trigger)--true) //J|EpE 22 TTrigger (扳机 键 ) 
{ 


mi 


starbutton.OnButtonDown (); 


// 调 用 到 红色 Cube 的 开始 按钮 


新 建 一 个 场景 并 命名 为 BasketBall， 然 后 按 下 Ctrl+Shift+B 调 出 发 布设 置 菜单 ， 将 创建 好 的 两 个 场景 都 添加 进去 。 
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接 下 来 点 击 运 行进 行 测 坛 ， 现 在 我 们 就 可 以 从 开始 界面 进入 投篮 游戏 界面 了 。 


2. 投 篮 游戏 的 制作 


先 在 场景 中 创建 一 个 地 形 ， 然 后 将 地 形 大 小 调节 为 50x 50, 
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Р Create Empty Ctrl - Shift--N > Ho» 

; Create Empty Child Alt+Shift+N TY: 
3D Object Я сь 
2D Object > Sphere 
Light Capsule 
Audio \ Cylinder 
UI Plane 


Particle System Quad 


Camera Ragdoll... 
Center On Children = Т 
МаКе Рагепї Tree 

Clear Parent Wind Zone 


Apply Changes To Prefab 


| Terrain Settings 


Base Terrain 

Draw P" | 
Pixel Error O— [5 | 
Base Map Dist. 一 -一 一 -一 1000 | 
Cast Shadows "i 

Material | Built In Standard 
Reflection Probes | Blend Probes 


Thickness 1 | 
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E Script 
Ге; Scripts 
* Standard. 
M steamv 
БӘ Editor: 
= Extras 
Ex Materi - 
Prefal - 


E جڪ‎ "neus 


Main Camera 
Directional Light 
Terrain ` 


| t. Y! Terrain 


Raise / Lower Terrain 
Click to raise. Hold dawn shift to lower. 


Brushes gi ml ДШ 


т sv Terrain Collider 
None (Physic Materie © 


Material | | 
Terrain D'ata New Terrain 3 © 


Enable Tree Collider 


| Add component | 


Add Terram | exture 


也 可 以 在 场景 中 添加 一 些 树木 ， 让 整个 场景 更 自然 。 


Edit Assets  GameObject Component Valve Mobile Input Window Help 
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创建 一 个 Plane， 将 篮球 地 板 贴图 添加 上 去 ， 并 放 到 地 形 场 景 中 。 


X1 Y 1 
(т; Plane (Mesh Filter) 


Mesh 8 Plane 
ai^ 
—— Y _ «y Mesh Collider 


T мебан di Scr Convex LJ 

Fig picture Scrios | is Тпддег 

^i Plugins GE standard As | Material None (Physic Mat 0 
"igi res i Steam VR — Û Plane 


R 
| ë anash | — т. Mesh Renderer 
三 :ierarcny [leone а =) Cast Shadons Ün 
Сге” | (erall Recewe Snadows м 


| тє BasketBall* ^| Моол Месо — y 
Dired:ona! Light Y Materials 


Terrain 


57 Sze 1 
rec 
v Gilma Elemenr C Ы plane 


Reflection Probes — blent Probes 
Anchor Override None (Transform 


2 glane "T 
T Shader | Stantard 


Rendering Моје — Opiq:e 


Main Maps 


Пом — [7 
© Metalic 
Smoothness r 0.5 


preis Ya  Transf« ; 
ict | à - 4 endi eo NEA 
= hd beilo Position X -4.284' Y -2. 2.037: Z 1.554: 
> > again Rotation X Q Y 180 Z0 
i Resour | ITI Scale X1 Y 1 21 
sm Scene ma fioor Y . Plane (Mesh Filter) ©, 
me = i grass Mesh Ш Plane | 
Scripts ~ lego -一 
каа Standa ай» quan jing Y sf Mesh Collider - Ц e. 
Pi SteamVR | сеге | каты ш 
Pu Streami Is Trigger 
"a terraino | Material None (Physic Mat © 
G Texture Mesh U Plane 


„тне! аьа 
— _ 0 EN — *. m Mesh Renderer 


ТЕ Hier à: chy | 1 : Co gola | B. ТЕ Cast Shadows | On 
|| Create ” (САП Receive Shadows |w 
Y€) BasketBall* Motion Vectors Ed 
Directional Light т Materials 
Terrain 
> Tree 
Y Game 


Light Probes 
Reflection Probes г Blend Probes 4 : 
Anchor Override None (Transform е | 


p'ane 
Shader | Standard 


Rendering Mode | Ogaqua : | 


| jS Albedo [ |7 
a Metallic O—— | 
Smoothness —— 05  — 
Source | Metallic Alpha — — 4| 


然后 将 在 3D Max 中 制作 好 并 导入 进来 的 篮球 架 也 拖 到 场景 中 。 


将 头 显 专用 的 摄像 机 拖 到 场景 中 ， 并 放 到 球场 中 央 的 位 置 ， 同 时 给 右手 柄 模型 添加 碰撞 器 和 刚体 。 
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将 导 进 来 的 篮球 拖 到 场景 中 作为 游戏 开始 的 触发 器 ， 同 时 创建 一 个 C# 脚 本 并 命名 为 StarGame， 将 其 拖 到 篮球 身上 以 使 该 篮球 持续 旋转 。 


public class StarGame : MonoBehaviour 


{ 
void Update () 


I 
) 


transform.Rotate (new Vector3 (0,0,3)); 


Reflection Probes 


< Plugins zs Script Anchor Override 


"mires Wg Scripts "A  Rigidbody 
i Resource E Standard As | Mass 
iS Scene M4 | =< | Drag 
& Script таг еси 79 Angular Drag 
E Use Gravity 


| | ! |. Is Kinematic 
йз < Ts Interpolate 
Directional Light 
Terrain 
P Tree 


Collision Detectior Discrete 
Y Constraints 
Freeze Position | |x | JY [JZ 


Y Game 
GtarGame Freeze Rotation Lx m; = 


TTA x vé М Sphere Collider | 
Plane F3 
| Edit Colli » 
EventSystem It Collider 


b [CameraRig] Is Trigger 
Material 
Center — 
X o | 
Radius ` [0.02782536 — | 
TG M Star Game (Script) =. | 
Script o StarGame 


当 手 柄 碰 到 该 篮球 并 扣 动 扳机 之 后 投篮 游戏 正式 开始 ， 创 建 一 个 C# 脚 本 并 命名 为 starButton， 将 其 抑 到 右手 柄 模型 上 ， 写 入 以 下 代码 : 


public class StarButton : MonoBehaviour 


public bool isbegain-false; а | 断 游戏 是 否 开 始 
public SteamVR — ` 
void OnTriggerStay (Collider . 

/ 833-45. PEANT PTEE 

{ 


StarGame star = other.GetComponent«StarGame» (); 
if (star != nu 


{ 


SteamVR Controller.Device device-SteamVR Controller.Input ((int)trackedobject.index); 
if (device.GetTouchDown (SteamVR Controller.ButtonMask.Trigger)-- 


DA 游戏 开始 
qim n = true; 
stroy (star.gameObject); 
LL р pie 游戏 


} 


true) 


} 
} 


Center 
EventSystem X 0.039749: Y -0.068197 Z -0.09136< 
* [CameraRig] Size | | 
> Controller (left) X/0.433757: Y [0.272765] Z |0.702616: 
| Controller (right) ES 
MS 


Star Button (Script) (Шш) + 
i Dt starButton o 


Б Саига s (head) š 9 
sbeqa 


ваени, м, .. Controller (righ 


选择 右手 柄 控制 器 ， 创 建 一 个 投篮 的 C# 脚 本 并 命名 为 Throw， 将 其 拖 到 右手 柄 上 。 双 击 打开 该 脚本 进行 编辑 : 


[RequireComponent (typeof 
public class Throw : 


{ 


ic 


float Veloci! 


lic GameObject perfab; 
public Rigidbody at 


tachPoint; 


tyScale = 3f; 


SteamVR TrackedObject trackedObj; 


FixedJoint joint; 
void Awake () 


F(SteamVR TrackedObject))] 
MonoBehaviour 


trackedObj = GetComponent«SteamVR TrackedObject»(); 


} 
void FixedUpdate () 
{ 


StarButton star = FindObjectOf 
(star.isbegain == 


pia pus 


var device 
if (joint 


{ 
// 通 过 预制 
var go = 


SteamVR Control 


^ Ju RIT < S: HU ALS PR 
GameObject.Ins 
go.transform.position 


tantiate 


joint 
joint 


} 


else 11 


{ 


FType«StarButton» 
true) // 判 断 游戏 是 否 开始 


attachPoint. 


0; 


Ж ler.Input ( (int) trackedObj.index); 
null && device.GetTouchDown (SteamVR Controller. 


ButtonMask. Trigger) ) // 检 测 到 扳机 键 按 下 并 且 当 前 连接 点 为 空 的 时 候 


(perfab); 
trans 


Form.position; 


go.AddComponent«FixedJoint» 
.connectedBody = attachPoint; 


var go = joint.gameObject; 


// 获 取 当 前 抛 出 物体 上 的 刚体 


var rigidbody = 


// 当 物体 被 抛 出 时 ， 删 除 joint 组 件 


Object.Des 
joint - 
Object.Des 


croylmmediate (joint); 
null;//3zjoin £ 
troy (90, 
Resources.UnloadUnusedAssets 


5.0£); 
0; 


(); 


f (joint != null && device.GetTouchUp (SteamVR Controller.ButtonMask.Trigger)) 
// 检 测 到 扳机 键 抬 起 同时 物体 的 连接 点 不 为 空 


的 时 候 


go.GetComponent<Rigidbody> (); 


t 为 空 ， 等 待 下 一 次 物体 生成 


// 通 过 三 目 运算 判断 当前 抛 出 对 象 是 否 有 相对 父 对 象 的 位 置 


var origin 


trackedObj.origin 


if 


(origin !- null) 


trackedObj.origin : trackedObj.transform.parent; 


{ 
// 使 当前 物体 刚体 的 速度 等 于 相对 父 对 象 位 置 处 扳机 键 松 开 时 手柄 的 位 移 速 度 


rigidbody.velocity = origin.TransformVector (device.velocity * VelocityScale); 


} 


else 


{ 


rigidbody.angularVelocity = origin.TransformVector (device.angularVelocity); 


rigidbody.velocity = device.velocity * VelocityScale; 


rigidbody.angul 


} 


rigidbody.maxAngul 


arVelocii 


arVelocit 


ty — device.angularVelocity; 


y = rigidbody.angularVelocity.magnitude; 


保存 代码 并 退出 ， 将 导入 进来 的 篮球 储存 为 预制 件 形式 ， 然 后 选中 右手 柄 并 做 如 下 配置 。 


rias 
Is m. 


NONE 


Controller (right) 


在 场景 中 新 建 两 个 Cube， 当 作 重 新 开始 触发 器 ， 将 开始 场景 中 创建 的 材质 球 继续 添加 给 该 投篮 场景 中 的 Cube， 同 时 做 如 下 配置 。 


a Unity Personal (64bit) - BasketBall.unity - VIVEBasketball - PC, Mac & Linux Standalone <DX11> 
File Edit Assets GameObject Component Valve Mobile Input Window Help 


|Shaded —  -||20|| € Q) | md | Create *| @ Jj a| x | 


"cre Tag and + Layer (Defaut +| 


在 红色 Cueb 上 添加 一 个 新 的 C# 脚 本 ， 命 名 为 TryButton， 双 击 打开 并 编辑 如 下 代码 : 


public class TryButton : MonoBehaviour 


{ 
public void OnTryButton() 
{ 


print ("FA FH"); 
Application. LoadLevel (1); 
} 


Ta 


— Layer (Defaut t) 


同时 在 右手 柄 模型 上 新 建 一 个 C# 脚 本 并 命名 为 TryAgain， 双 击 打开 并 编辑 如 下 代码 : 


public class TryAgain : MonoBehaviour 


public SteamVR TrackedObject trackedobject; 
void OnTriggerStay (Collider other) 
{ 
TryButton trybutton = other.GetComponent«TryButton» (); 
if (trybutton !- null) 
{ 
SteamVR Controller.Device device-SteamVR Controller.Input ((int)trackedobject.index); 
if (device.GetTouchDown (SteamVR Controller.ButtonMask.Trigger)--true) 
// 当 扣 动 扳机 键 的 时 候 ， 激 活 红色 Cube 上 的 重新 开始 按钮 
{ 
trybutton.OnTryButton (); 
] 
} 
} 


) 


在 右手 柄 模型 上 将 右手 柄 控制 对 象 托 上 去 。 


最 后 给 篮球 创建 一 个 物理 材质 球 ， 物 理 材质 球 可 以 用 于 调整 碰撞 对 象 的 摩擦 力 和 上 反弹 效果 ， 物 理 材 质 球 的 创建 路 径 是 Assets 一 Create 一 Physics Material, 


对 创建 好 的 物理 材质 球 做 如 下 参数 调整 : 


物理 材质 球 的 各 属性 见 下 表 : 


属性 功能 

移动 时 使 用 的 摩擦 力 ， 通 常 值 为 0 一 1。 值 0 的 状态 类 似 于 冰 , 值 1 
会 使 其 非常 快 地 静止 下 来 ， 除 非 有 很 大 的 力 在 推动 对 象 

对 象 在 某 个 表面 上 保持 静止 时 使 用 的 摩擦 力 ， 通 党 值 为 0 一 1。 值 0 
的 状态 类 似 于 冰 , {Н 1 会 使 对 象 非常 难以 移动 


JSEJ] (Dynamic Friction) 


ШЕ 8 JJ (Static Friction) 


Jf JJ (Bounciness) 表面 的 反弹 程度 。 值 0 不 会 反弹 ,， 值 1 会 反弹 而 不 损失 任何 能 量 
EJJA H (Friction Combine Mode) 两 个 储 撞 对 象 摩 探 力 的 合并 方式 

EÊ (Average) VES IA BET JJ (k BA] (Rl 

最 小 (Min) 使 用 两 个 值 的 较 小 值 

最 大 (Max) 使 用 两 个 值 的 较 大 但 

ЖЕ (Multiply) BE P JJ (ELTE E 

合并 反弹 (Bounce Combine) 两 个 碰撞 对 象 弹 力 的 合并 方式 。 其 模式 与 “摩擦 力 合并 模式 ”相同 


各 回 异 性 方向 。 如 采 此 方 癌 不 为 索 ， 则 局 用 各 回 异 性 摩 探 力 -。 “动态 
摩 探 力 2” 和 “静态 摩擦 力 2” 会 随 “ 摩 探 力 方向 2” 一 起 应 用 
如 果 启 用 各 向 异 性 摩擦 力 ， 则 “动态 摩擦 力 2” 会 随 “ 摩 擦 力 方向 2” 


FEE JJ J; [n] 2 (Friction Direction 2) 


动态 附 氛 力 2 (Dynamic Friction 2 ) 


一 起 应 用 
L Au RJ АН 226-10] ТЕРЕК JJ. BHD “р БЕЕК) 2” Abi FERI] 2" 
Bh S Eje JJ 2 (Static Friction 2 ) 起 应 用 


在 创建 好 篮球 的 物理 材质 球 之 后 把 物理 材质 球 拖 到 篮球 身上 即 可 。 
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17.3 ”导出 与 运行 


按 下 Ctrl+Shift+B 调 出 导出 设置 ， 选 择 平台 为 PC 平台 ， 点 击 Player Settings， 做 如 下 参数 调整 ， 最 后 点 击 导 出 (Build) 。 


Scenes In Build 


i Scene/Start 
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5 Tizen Use DX11/ES3 GPU Skinning 


Е Rendering Path* | Forward 
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Auto Graphics API for Wir 
[XJ Xbox One 


Learn about Unity Cloud Build "e арпа API for Мац 
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[ Switch Platform sie bucina 
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Y Model Graphics Jobs (Experimer| | 
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attach : . 
Virtual Reality SDKs 
> Camera (head) r i 


将 导出 成 功 的 .exe 游 戏文 件 添加 到 Steam 游戏 平台 上 。 
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最 后 就 可 以 在 Steam 平台 上 运行 投篮 游戏 了 。 


Oculus 成 立 于 2012 年 ， 是 目前 世界 上 最 大 的 VR 品 牌 之 一 。 在 2014 年 7 月 的 时 候 ，Facebook 以 20 亿 美元 的 价格 收购 了 Oculus， 引 起 了 社会 各 界 的 广泛 关注 。 由 此 可 见 Facebook 对 于 虚拟 现实 的 态度 ， 
同时 虚拟 现实 行业 的 未 来 也 越 来 越 被 人 们 所 关注 。 


Oculus 目 前 主要 以 硬件 产品 为 主 ，Oculus Rift DK1 和 DK2 (如 下 图 ) 都 属于 开发 者 版 本 ，Oculus Rift 不 只 是 一 个 硬件 系统 ， 而 是 包含 软件 开发 工具 包 在 内 的 一 整套 开发 系统 。 用 户 使 用 该 版 本 不 仅 可 
以 体验 到 炫 酷 的 VR， 还 可 以 开发 自己 的 VR 游 戏 。 


2016 年 1 月 7 日 零点 ，Oculus Rift CV1 正 式 接 受 预订 。 这 是 Oculus Rift 的 零售 版 ， 包 装 内 除了 头 爸 外 ， 还 配备 有 一 个 Xbox 手柄 和 两 款 自 带 游戏 。 


访问 https://developer.oculus.com/ 注 册 自 己 的 开发 者 账号 并 登录 ， 下 载 Oculus Rift Runtime, 


Start Building 


Start turning your dreams into virtual realities. 


Rift Runtime Other Downloads 


然后 在 OtherDownloads 里 根据 自己 所 使 用 的 操作 系统 与 开发 平台 下 载 相 应 的 开发 组 件 与 工具 包 。 安 装 并 调试 好 ， 就 可 以 开发 自己 的 Oculus Rift 项 目 了 。 


Oculus 成 立 于 2012 年 ， 是 目前 世界 上 最 大 的 VR 品 牌 之 一 。 在 2014 年 7 月 的 时 候 ，Facebook 以 20 亿 美元 的 价格 收购 了 Oculus， 引 起 了 社会 各 界 的 广泛 关注 。 由 此 可 见 Facebook 对 于 虚拟 现实 的 态度 ， 
同时 虚拟 现实 行业 的 未 来 也 越 来 越 被 人 们 所 关注 。 


Oculus 目 前 主要 以 硬件 产品 为 主 ，Oculus Rift DK1 和 DK2 (如 下 图 ) 都 属于 开发 者 版 本 ，Oculus Rift 不 只 是 一 个 硬件 系统 ， 而 是 包含 软件 开发 工具 包 在 内 的 一 整套 开发 系统 。 用 户 使 用 该 版 本 不 仅 可 
以 体验 到 炫 酷 的 VR， 还 可 以 开发 自己 的 VR 游 戏 。 


2016 年 1 月 7 日 零点 ，Oculus Rift CV1 正 式 接受 预订 。 这 是 Oculus Rift 的 零售 版 ， 包 装 内 除了 头 盘 外 ， 还 配备 有 一 个 Xbox 手柄 和 两 款 自 带 游戏 。 


访问 https://developer.oculus.com/ 注 册 自 己 的 开发 者 账号 并 登录 ， 下 载 Oculus Rift Runtime, 


Start Building 


Start turning your dreams Into virtual realities. 


Rift Runtime 


Other Downloads 


然后 在 OtherDownloads 里 根据 自己 所 使 用 的 操作 系统 与 开发 平台 下 载 相 应 的 开发 组 件 与 工具 包 。 安 装 并 调试 好 ， 就 可 以 开发 自己 的 Oculus Rift 项 目 了 。 


1. 设 备 介 绍 


GearVR 是 三 星 与 Oculus 合 作 推 出 的 一 款 手 机 端 VR 头盔 。 消 费 者 版 本 的 GearVR 在 侧面 添加 了 一 个 触摸 板 ， 用 来 完成 各 种 各 样 的 交互 操作 。 无 论 是 从 设计 还 是 体验 来 说 ， 这 都 是 一 款 非常 优秀 的 VR 头 


时 


GearVR 的 售 价 为 99 美 元 ， 由 于 是 手机 端的 头盔 ， 因 此 官方 要 求 最 低 配 置 必须 是 三 星 Note4 或 者 是 $6 才 可 以 使 用 。 如 果 你 正好 有 这 样 一 款 手 机 ， 那 么 这 个 价格 真 的 是 无 可 挑 吻 ， 但 是 如 果 没 有 ， 那 么 成 
本 无 疑 就 高 了 。 


2. 开 发 流程 


(1) 首先 下 载 移动 端 SDK， 由 于 GearVR 是 与 Qculus 合 作 制 作 的 ， 所 以 开发 部 分 还 是 基于 Oculus 移 动 端的 SDK， 依 然 是 在 https://developer.oculus.com/ 创 建 开发 者 账号 并 下 载 移动 端 SDK。 


SDK & RUNTIME 


Oculus Mobile SDK v1.0.3 Details 


(2) 下 面 配置 Android SDK， 由 于 是 手机 端的 头 显 ， 而 三 星 手机 又 是 基于 Android 平 台 ， 所 以 在 GearVR 上 开发 应 用 时 还 需要 Android 的 SDK。 安 装 Android SDK 需 访问 


developer.android.com/sdk/installing/index.html, 
安装 完成 后 ， 有 可 能 需要 进行 调试 ， 下 面 是 一 个 很 好 的 安 卓 调试 工具 : developer.android.com/tools/debugging/index.html, 


(3) 使 用 移动 端的 Oculus SDK 构 建 的 VR 应 用 需要 一 个 唯一 的 签名 才 可 以 调用 更 底层 的 API。 访 问 Oculus 的 开发 者 官网 developer.oculus.com/osig/， 关 于 ID 获取 以 及 签名 生成 的 具体 方法 都 有 详细 的 
说 明 。 


(4) 想 要 在 手机 上 构建 部 署 自己 的 应 用 ， 需 要 先 打开 USB 调 试 ， 关 于 这 些 ， 可 访问 http://forums.androidcentral.com/samsung-galaxy-tab-pro-8-4/371491-enabling-developer-mode.html。 


至 此 ， 环 境 搭建 完成 ， 开 始 你 的 GearVR 应 用 开发 吧 。 


18.3 ABBVRISIT 


1. 设 备 介 绍 


大 朋 VR 是 目前 国内 领先 的 虚拟 现实 互联 网 企业 ， 拥 有 国际 水 平 的 PC 端 和 移动 端 虚拟 现实 头 戴 产品 ， 目 前 国内 市 场 占有 率 达 到 68%。 它 还 拥有 最 大 的 VR 内 容 聚合 平台 3D 播 播 ， 平 台 用 户 数 高 达 300 万 。 
大 朋 VR 由 国内 第 一 个 可 穿戴 计算 机 实验 室 的 核心 人 员 和 对 虚拟 现实 技术 有 狂热 爱好 的 梦想 家 所 建立 ， 坚 持 以 用 户 体验 为 中 心 ， 做 最 受用 户 喜爱 的 可 穿戴 设备 ， 公 司 员工 多 是 来 自 Intel、ARM、 百 度 、 腾 
讯 、 盛 大 和 PPTV 等 公司 的 顶尖 高 手 ， 另 有 可 穿戴 计算 、 虚 拟 现实 、 增 强 现 实 、 人 工 智能 领域 的 世界 知名 科学 家 顾问 团队 。 


大 朋 VR 专 注 于 虚拟 现实 头 戴 显 示 产 品 的 开发 和 虚拟 现实 内 容 平台 的 建设 ， 致 力 于 打造 以 硬件 系统 为 核心 、 软 件 内 容 同 步 发 展 、 聚 合 游戏 及 影视 等 多 方 资 源 的 VR 生 态 。 


2. 开 发 流程 


访问 大 朋 VR 开 发 者 官网 http://developer.deepoon.com/ 下 载 自己 所 需要 的 SDK 或 者 其 他 的 资源 包 。 


Code 


Sample Code Development Platform 


% 


Tutorials Developer Guide Partners 


目前 支持 以 下 三 种 平台 : 


UnrealPlugin UnityPlugin Platform SDK 


AD «Qunity 


大 朋 VR 


Deepoon 
UNREAL 


ENGINE 


SDK 及 官网 中 都 有 非常 详细 的 文档 介绍 说 明 ， 大 家 下 载 安装 后 就 可 以 在 相应 的 平台 上 进行 开发 了 。 


18.4 PSVR 


索尼 公司 在 游戏 圈 的 地 位 组 庸 置疑 ，VR 游 戏 如 此 火爆 ， 这 位 行业 大 佬 怎 能 无 动 于 衷 ? 2016 年 3 月 16 日 ， 索 尼 正 式 推出 PSVR， 立 刻 引 起 了 广泛 关注 ， 当 天 下 午 ， 亚 马 逊 上 的 第 一 批 设备 在 短 短 几 分 钟 内 
к, 


PSVRBESE:1733992&7v, (ВНК, S EPSVREE UR GPSACEBHUAIPSVRESERSCSR, — 9588869970. ix M FEEDS] OculusfüHTC Vive 来 说 是 一 个 优势 ， 更 何况 PSVR 不 需要 额 
外 再 配 一 台 高 配置 的 主机 。 所 以 对 于 想 要 体验 高 级 别 VR 设 备 的 读者 来 说 ，PSVR 无 疑 是 最 具 诱惑 的 ， 再 加 上 索尼 在 游戏 方面 多 年 的 经 验 积累 ，PSVR 值 得 期 待 。 


